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PREFACE 


The OS/32 Operator Reference Manual is intended for 0S/32 system 
operators. 


Chapter 1 gives a general description of 9S/32. Chapter 2 ° 


discusses the procedures for loading either the Perkin-Elmer 
supplied starter systems or uSer-generated systems. Chapter 3 
defines the operator commands. Chapter 4 discusses error 
handling and maintenance utility programse Chapter 5 discusses 
the command substitution system (CSS). Chapter 6 briefly 
describes the accounting facility used in monitoring system 
usage. Appendix A contains operator commandse Appendix B is a 
command message summary. Appendix C describes system messages. 
Appendix D contains system crash codes. 


The TET notice (Chapter 5) is deleted. The Disk Utilities 
(Chapter 6), Dump Print Utility (Section 4.7), Spooler (Chapter 
7 and Section 3.46), and Contents of Mag Tape Produced by a 
Stand-Alone Dump (Appendix E) are now found in the new 05/32 
System Support Utilities Reference Manual. The Command 
Substitution System, previously Chapter 8, is now Chapter 5. All 
HLOC information (Chapter 9) is obsoleted. Application of Systen 
Extensions (Chapter 10) is obsoleted. 


This manual replaces $29-574. It adds the DISPLAY ACCOUNTING and 
XALLOCATE commands and the SPAUSE, SCONTINUE, and SWAIT CSS 
commands. The LOAD command is more flexible, and system log 
files can now be checkpointed using the SET LOG command. The 
amount of sysStem space a task uses and pseudo tasks are displayed 
with the DISPLAY MAP command. The Memory Diagnostics section is 
reorganized under the NEMORY command, and vertical forms control 
support is included for the appropriate commanis. 


This manual applies to the OS/32 R06 software release and higher. 


These related publications can be used in conjunction with this 
manual: 


MANUAL TITLE : PUBLICATION 
NUNBER 
0S/32 Link Reference Manual | 48-005 


CS/32 Systen Planning and Configuration Guide 48-924 
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OS/32 System Support Utilities Reference © 


Manual 48-031 
OS/32 Supervisor Call (SVC) Reference Manual 48-038 
OS/32 Application Level Programmer 

Reference Manual , u8-039 
OS/32 Multi-Terminal Monitor (MTH) 

Reference Manual 48-943 
32-Bit Systems User Documentation Summary 59-003 


For further information on the contents of all Perkin-Elmer 
32-bit Manuals, see the 32-bit Systens User Documentation 
summary. | 
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| _ CHAPTER 1 | 
INTRODUCTION TO COMPUTER OPERATIONS UNDER 0S/32 


1-1 INTRODUCTION 

OS/32 is a comprehensive multitasking environment with minimal 
System overhead that is controlled from an interactive console. 
The OS/32 environment includes foreground tasks for combining and 
forming application systems, and background tasks for program 
development and general data processing. 


4.2 MINIMUM HARDWARE CONFIGURATIONS 


The minimum hardware configurations for OS/32 are: 


® Perkin-Elmer 32~bit processor with 128kb of memory 


® Relocation/protection hardware (memory access controller (MAC) 
or memory address translator (MAT)) 


e® Display panel (for 7/32 and 8/32 processors only) 
o® Universal clock 


e Console device options: 


- Teletypes (TTY) (Models 33 and 35) 
- TEC Video Display Unit (¥DU) 
- Perkin-Elmer Carousel 15, 30, 35, or 300 


- Perkin-Elmer Model 550, 5508, 1100, 1200, 1250, or 1251 YDJ 


® Power fail/auto restart 


@® Magnetic media options: 


- Magnetic tape (9-track 800, 1600, 6250 bpi) 
- Disks (2.5MNb, 1ONb, 4OMb, MSNBO, MSM300) 


ae Floppy disk 
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® I/0 device options: 


- Line printer (120, 180 cps; 300, 600, ani 1000 lpm) 
~- Card reader (400 or 1000 cpm) 
~ Paper tape reader/punch 
= Card punch 
© Data communications interfaces (PALS, PASLA, SSA, QSA, 2- and 
8-line COMM HUX, CLCM) | 


® Special device options: 


- Loader storage unit (LSU) 
- Eight-line interrupt module 
~ Video display (TTY interface or PASLA/PALS) 
- Digital multiplexor 
~ Mini I/O systen 
~ Real time analog system 
@ OS/32 can be configured to run without direct saneee devices. 
However, at least one disk is required to: 
- unpackage the software, 
- perform a system generation (sysgen), and 


- do program development. 


1-3 THE OS/32 ENVIRONHENT 


OS/32 is a general purpose multitasking, multi-environment 
system. Basic OS/32 provides a. background environment for 
program development and debugging and a foreground environment 
for prioritized real time applications. Additional environments 
are provided by these OS/32 products: 


» Multi-terminal monitor (HTN) provides a secure multi-user, 
time-sharing environment for program development and 
debugging. 
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@ Reliance is.a complete online transaction processing software 
package «for the commercial user of Perkin-Elmer 32-bit 
computers. 


OS/32 also provides many facilities to allow conplete 
application-oriented environments to be easily constructed. 


1.3.1 The Operator in an OS/32 Environment 


The OS/32 system is controlled by the system operator through a 
device called the system console. This device can be a TTY, VDU, 
Carousel, or a Model 550, 1100, 1200, or 1250 VDU. It has a 
special relationship to the system in that the system receives 
command input from the console and writes system messages to it. 
Tasks can log messages to the system console without reference to 
its device name. A comprehensive command set is provided to 
allow the system operator to control and interact with the 
various OS/32 environments. Normally, the operator does not 
interact with foreground tasks except when loading and initiating 
them, but the operator can monitor and control them if necessary. 


. The background facilities offer the operator more control of jobs 
and job streams. These facilities are used for program 
development functions such as: 


® assembling, 

® conpiling, 

@® linking, and 

@ performing a sysgen. 

To use these functions, the operator must unierstand the task 
control functions available under OS/32 and the program's 
specific operational requirements. | Through operator commanis, 
the operator frequently interacts with the disk file systen. 


These commands are detailed in Chapter 3. 


The operator must understand the OS/32 Command Substitution 
System (CSS). These conmands are detailed in Chapter 5. 


HTH enables users to simultaneously share a 32-bit processor via 
terminals, which adds another dimension to the  operator’s 
activities. 


16048 SYSTEM CONSOLE USE 
The system console is uSed to enter cammands and receive status 
displays and error responsese Significant events sucrh as disk 


failures, power fail/restore, and task terminations are logged to 
the. console, 5 
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OS/32 provides, through the SET LOS command, an optional copy of 
all transactions to and from the console... The log may be 
directed to a hard copy device or to a file for later printing. 


The system console can be assigned to tasks for ordinary I/0 
operations the same as any other device. If the system console 
is an ASR TTY or Carousel 35, only its keyboard/printer unit can 
be used for calling tasks; the reader/punch unit is reserved for 
‘system uSe. 


4.68.1 Prompts 


When the system operator is expected to enter data at the system 
console, a prompt is output. This prompt’ takes one of the 
following forms: 


* Command request 
taskid> Data request 


»«CHDP> Build request 


The command request prompt (*) is output whenever the system is 
ready to accept another command. 


The data reguest prompt (taskid>) is output whenever a task is 
attempting to perform a read request to the system console. fhe 
taskid field of this prompt is the name of the the task 
requesting data. For the background task, the taskid is .BG. 
The system operator should satisfy the data request as soon as 
possible, Since system messages ane held up until the data 
request is satisfied. : 


The build request prompt (.CMDP>) is output whenever the command 
processor task is requesting input. This occurs during the 
processing of a BUILD command. 


124.2 BREAK Key 


If a task is in the process of reading from or writing to the 
system console, the operator can interrupt by pressing the BREAK 
key (ESC on some devices) of the console device. This forces the 
system into command mode for the entry of one command Iline. 
After the command line has been accepted, the user I/0 to the 
console. is restarted. This process is transparent to. the user 
task 


The BREAK key can also be used by the operator to terminate 
further system responses to a command. This is particularly 
useful in cases such as the EXAMINE and DISPLAY commands, where 
large quantities of data may be output to the system console. 
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1.5 GENERAL SYNTAX RULES 


Multiple commands may appear on one line, but each one must be 


“separated by a semicolon (;). Certain commanis must appear last 


on a line or must be the only command on the Mine. These 
restrictions are discussed in the sections dealing with the 
individual commands. If the first character of any command input 
is an asterisk (*), the remainder of that line is considered to 
be a comment and is not executed. It is copied to the system log 
device if logging is active. 

12521 Statement Syntax Conventions . 

These statement syntax conventions are used in all statement, 
command, and instruction formats: 

Capital letters must be entered exactly as shown. 


DELETE fd, [- Eds, Ce ee fay] 


Lowercase letters represent parameters or ijenote information 
provided by the user. 


CANCEL taskid 
Punctuation must be entered exactly as showne 


Commas separate parameters and substitute missing positional 
parameterse 


DELETES £d,y [,fdoveeer fey | 


Commas preceding braces inside brackets must be entered if one of 
the optional parameters is chosen. 


fd 
DISPLAY ERRORS 


Comma inside brackets must be entered if the optional parameter 
is chosen. . 


BEILE fd Used for magnetic tapes and 
cassettes only . 


EEILP £d-[2 1] Used for disk devices only 
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Comma outside brackets except last parameter must be. entered in 
place of a missing positional parameter, to separate chosen 
optional parameters, and with the last specified parameter. 
Commas are omitted for trailing parameters. 


AFCONT RESIDENT SYCCONTINUE 
QPTIONS |< | ioe eR ee ; 1 rere 
eee 4 
° a it 


Ellipsis represents an indefinite number of parameters or a range 
of parameters. 


BUILD fd 


ENDB 
Brackets represent an optional parameter. 
CONTINUE [address] 


Braces represent required parameters from which one must. be 
chosen. 


lu, [, lus, *@o@ = 


CLOSE 
ALL 


Underlining points out the mnemonic of the entry and means the 
underlined portion must be entered. 


PAUSE 


Shading represents a default option. 


BYS 
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Equal sign. associates A parameter with its keyword. 


ARAMETER[,RECL=recl] [,SIZE=size]| 


can oe 


_ MARK dev:,JQFF : 
PROTECTED 
ON |,4 SYSTEM e@CDIRECTORY [=< 


RESTRICTED 


40562 Uppercase and Lowercase Characters 


All commands and parameters can be entered in either uppercase or 
lowercase. Parameters that are retained internally (such as task 
identifiers) are translated to uppercasee A subsequent display 
will show the uppercase version. 


1.5.3 Decimal and Hexadecimal Numbers 
The OS/32 commands use decimal, rather than hexadecimal, numbers 
for most numeric operands. A major exception is addresses, which 
. are expressed in hexadecimal. Numeric operands are always 
integers except for the SET SYS and ICOM commands, and the 
segment Size increment field of the LOAD command where the 
decimal point is permissible. Leading zeros can be omitted in 
numerical operands, whether decimal or hexadecimal. 
1.5.4 Task Identifiers 
Task identifiers must consist of one to eight alphanumeric 
characters; the first character must be alphabetic. Valid task 
identifiers are: 

TASK3 

MAX 

X 


T9O7XY25 


Invalid task identifiers are: 


34TASK The first character is not alphabetic. 
T43.2 It contains a nonalphanuneric character. 
TASKI2345 It contains more than eight characters. 


The background task has the special identifier .BG. 
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12.5.5 File Descriptors 


File descriptors, 


format. 


Format: 


en 
dev: 


Parameters: 


voln: 


dev: 


filename 
©e@xXt 


actno 


abbreviated as fd, are entered in a standard 


[filename] [- Lex] [Yactno} 


is the name of a disk volume. It may be from 


one to four characters) long. The first 
character must be alphabetic and the 
remaining, alphanumeric. If voln: is not 


specified, the default is: 


- TEMP volume for temporary files, 
- SPOOL volume for spool files, and 


- SYSTEM volume for all other files. 


is a 1- to 4-character device name. The first 
character must be alphabetic and the 
remaining, alphanumeric. 


is the name of a file and is from one to eight 
characters long. The first character must be 
alphabetic and the remaining, alphanumeric. 
If a filename is specified when a device 
mnemonic is specified as voln, the filename is 
ignored. 


is the name of the extension and consists of 
from one to three alphanumeric characters. [f£ 
-28xt is not specified, a default extension 
corresponding to the appropriate command is 
appended. If the period (.) is specified 
with no extension, the default is blanks. 


is a decimal number ranging from 0 through 255 
specifying the account number associated with 


the file. Account numbers 1 through 250 are 
used by NTM; account numbers 251 through 255 
acre reserved. Account number O is used for 


system files and is the default for all 
operator commands. , 
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Examples: 


PACK:CAL-TSK/0 PACK: is the volume name, CAL is 
the filename, .TSK is the extension 
name, and O is the account numbere 


CONYV.CAL CONY is the filename, eCAL is the 
extension name with a default file 
class on the default volume. 


CAL CAL is the filenane with a default 
extension, default file class, ani 
default volume. 


M300:MAR ‘M300: dis the volume name, MAR is 
the filename with a default 
extension and default file class. 


CARD: | CARD: is the device mnemonic. 


1-6 ERROR RESPONSE 


Ifa command is not acceptable to the system or an error 
condition is detected while processing a command, a message is 
displayed on the system console. The general format of the 
message is: 


ERR=xxxx TYPE=yyyy POS=Z22Z22Z 
Hheres 
XXXX is an error descriptor of up to four 


characters (such as MNEM, ALLO, [0, etc.). 
Error descriptions are defined in each command 
description. 

VyYyy indicates the type of error encountered and is. 
output only when an I/O error, SVC 6, or SVC 
7 file-handler error is encountered. 

ZZZZ represents the last command item processed. 
This field is most useful when nmultiple 
commands are entered on one line. 


Refer to Appendix B for a complete list of messages. 


The error response to an unrecognized command iss 


MNEM-ERR 
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All commands following an erroneous command on a commnani line are 
ignored if the command line is entered from the system console. 
If the command line is entered from a CSS, all commands are 
handied as if they were on individual command lines. 


If the particular command cannot be accepted because of the state 
of the system, this message is displayed: 


SEQ-ERR 


Such restrictions are discussed in the explanations of the 
particular commands in Chapter 3. 
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CHAPTER 2 
LOADING OS/32 


201 INTRODUCTION 


0S/32 is stored into object o image format on one of these 
auxiliary devices: : 


® paper tape, 

® tape cassette, 

e@ floppy disk, 

® magnetic tape (all except 6250 bpi drives), or 


e disk device. 


OS/32 can be loaded fron an auxiliary device into memory by one 
of these loaders: 


® Relocating (REL) loader if 0S/32 is in object format stored on 
paper tape or magnetic media 


® Direct access bootstrap (BCOT) loader if OS/32 is in image 
format stored on magnetic tape or disk device and is to be 
loaded into a 7/32 or 8/32 system 


e Loader storage unit (LSU) if OS/32 is in image format stored 
on magnetic tape or disk device 


These loaders are described in two sections. The first section 
describes the loading procedures used for the 7/32 and 8/32 
systems which are entered through the display panel. The second 
section describes the loading procedures for the Perkin-Elmer 
3220 series processors, which are entered through the systen 
control terminal (with device address X‘'10'). 


Ze le il Starter Systens 


Ail starter systems can be loaded from a magnetic tape device by 
the REL loader (object format only), BOOTLOADER, or the LSU. 
OS/32 can also ba loaded f£rem a disk device by the BOOTLOADER or 
LSU. r. 


tN 
t 
aa 
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2e2 OS/32 BOOTSTRAP PUNCHER FOR PERKUN-ELMER HODELS 7/32, 8/32, 
3220, 3230, AND 3240 PROCESSORS 


The OS/32 Bootstrap Puncher converts the object versions of the 
32-bit REL loader and the OS/32 Bulk Storage Bootstrap Loader 
into 50-sequence loadable form. . 


2Ze2e1 Starting the Bootstrap Puncher 


4s HMount the media containing the bootstrap puncher. 


2. Load the bootstrap puncher (BTPCH32). 


LOAD 


3. Assign the input device or file from which the REL or 
BOCTLOADER is read. 


ASSIGN 1 


4. Assign the output device to which the REL or BOOTLOADER is 
written. 


ASSIGN 2 
Be Start the bootstrap puncher. 
START 


The logical unit (lu) assignments do not have to be made using 
the ASSIGN command. The assignments can be made via the START 
command. 


Fornat: 


START, fd ,,fd> 


Wheres: 
fd 4 is the fd of the input device. 
fc, is the fd of the output device. 
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Exanple: 


iL -BG, BTPCH32 
T .BC 
Sf ,RELLDR.OBJ,MAG1: 


This example places the REL loader on the front end of MAG1. 


2e2e2 Hessages for Bootstrap Puncher 


All messages are output to the system console in the following 


formats: 


Messages: 


ASGN-ERR TYPE=xxxx indicates 


LU=yy - I/O error 
where the 


8100 ERROR: LU=xx indicates 
assigned. 


ILLEGAL ASSIGNMENT indicates 
ON LUx the error 


that the variable xxxx is a type of 
and file access errore yy is the lu 
error cccurred. 


that the variable xx is the lu not 


that the variable x is the lu where 
SECUEESG- . 


Table 2-1 defines the error types. 


TABLE 2- 


ee em ee ee ee me re me ee ee ee ee ee 
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ne ee Bee Om ees eee at Gee Gt Ce ont ae om ame see ots ome me om 


1 ERROR TYPES 


{| ERROR | | | 
| TYPE { xxxx | DEFINITION | 
| SSS SSS SS SSS SSS SSS SS STS SS STS SSS SEnnsnssss es sSaess=e | 
| I70 | ILLU |] Tllegal or unassigned lu | 
{ |} PRTY | Parity or recoverable error ] 
| | UNRV | Unrecoverable error { 
| } EOF fj End of file _ a 
| | EOM | End of mediun | 
| | DU }] LCevice unavailable | 
| {| FUNC {| Invalid Cedars or alas | 
peneimatne anu ats ance aan eee eas 
| File {| FUNC | Tilegal function | 
J access | VOL | No such volume/device | 
| | LU ] Tilegal lu | 
| | NAME | Mismatched filename.ext | 
| } SIZE |] Erroneous record length or size | 
| | PROT | Mismatched protection key | 
| } PRIV j| Mismatched access privileges | 
{ }] BUFF {| Unable to abtain FCB | 
| | TYPE {| Nondirect access device | 


we ee ee ee es mt ee ee ee et ee me em ee eee ee ee eee en ome et ee ee ee ee 


2-3 LOADING OS/32 FOR HODELS 7/32 AND 8/32 SYSTERS 

The following sections describe the procedures for loading the 

desired loader and OS/32 through the display panel. 

2.3.1 Loading 0S/32 Using the REL Loader 

To load OS/32 object format, follow this procedure: 

1. Mount the media containing the REL loader and position it at 

load point. 

Ze Enter the 50 sequence: 
DTA-50-ADD 
DTA~CDSOO-WRT 
CT A-OOCF-WRT 


DTA-~4300-WRT 
DTA-OO080-WRT 


3. Enter into memory starting at location X'78* the device 
number and output command of the device containing the REL 


loader: 

DTA-78-ADD Address location X'78° 
0294 Teletype reader 
0399: High-speed paper tape 

reader 

71399\_y High-speed reader/punch 

pen HSA 4 ee Tape cassette (deck 0) 
S5A7 Tape cassette (deck 1) 
85A14 Magnetic tape (800 bpi) 
C5A1 Magnetic tape (1600 bpi) 


4. Clear the program status word (BSW) by entering: 
DT A-O-FN-1 


5. Initialize machine malfunction pointers by entering: 


CIA-84-ADD Address location X‘84' 
DTA-5SO000-HRT Set pointer to 5000 
CLTA-6000-WRT Set pointer to 6000 
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10. 


11. 


If the processor. is equipped with an LSU, the LSU must be 
off. . ; 


Initialize the processor and start executing at location 


X°50° by entering: 


INI-CIA~50-ADD-RUN 


Display the REL loader starting address by entering: 


FUN-LCC 


If OS/322 is not on the same media as the REL loader, mount 


the media containing OS/32 and enter into location X°78° the 
device number and outrut command of the device containing 
OS/32. See step 3. 


Specify the number of filemarks to skip and execute the REL 
loader to load OS/32 by entering: 


DTA~rel addr-ADD 
DTA-OOnn-RUN 


nn is the number of filemarks 


When loading is completed, the OS/32 id and.tlicense or 
contract are displayed on the systen console: 


OS/32nn-uUuuUeVVVVVVVV LICENSE x-xxxx-xXxxx-Xx 


nn is a decimal number indicating the 
revision level. 


uu is a decimal number indicating the 
update level. 


VVVVVVV is an 8-character alphanumeric 
string seer e the user version 
number. 


X-XX¥XX¥-XXKX Ais a series of alphanumeric characters 
identifying the license or 
contract of the system. 
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2e3e-2 REL Loader Error Check Procedure and Exror Codes 


es 


If the WAIT light does not come on, the OS/32 revision id is not 
displayed on the system console, or zeros are not displayed on 
the display panel, follow this error check procedure: 


1. 


Ensure that the device containing the REL loader is turned on 
and is online to the systen. 


Ensure that the device containing the REL loader is correctly 
positioned. 


Ensure that the data entered in the appropriate locations is 
correct. 


Load a different copy of the REL loader. 
If the error is not detected after performing steps 1 through 
4, a hardware error might exist. Check the display panel for 


the REL loader error codes (Table 2-2) or system crash codes 
(Appendix D). 


TABLE 2-2 REL LOADER ERROR CODES 


Om we eee ore ie ee ee em ee ee ee eo ee ee ee ee ee eee ee es ee ee Be ee ee ee ee ee ee ee ee es ee es ee ee ee ee ee ee ee 


ERRCR | { 
CODE |} NEANING | 
a a a a a ed == SS SSS SP SVT SV SV SS TST ST SVS SSS SS SS SSS | 
0000 | The load terminated normally. | 
| ! 

0001 } A checksum or parity error occurred. Press | 
| RUN to reread. | 

| 

0002 | A sequence error occurred; retry load. OS/32 |} 
|} may be defective or incomplete. . | 

| 7 , | 

0003 | An attempt to load over the loader occurred; ] 
| retry. | 

| | l 

ooo4 | An REF-DEF chain loop occurred; retry. | 
i 

0005 | The device is unavailable or is not positioned | 
J to the correct file. Check the device address. | 

| 

0006 | Selector channel (SELCH) specified is: { 
} incorrect. Check device and SELCH address. | 

| { 

0007 | End of file was encountered; retry load. | 
| | 

FFan } A load error occurred because an improper | 
| 

| | 


loader item nn was detected. Correct the 
control item and retry. 


— ee ee pe eee ee ee eee ee ee ee ee ee Oe eee et gee me ome eee ame wee eee Ble eee we ee ee et ee ee ee et re ee ee ee ee ee ewe oe 
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2e3e3 Loading 0S/32 Using the BOOT Loader 


To “load O0S/32 image format, follow this procedure: 


1. Mount the media containing the BOCT loader and position it at 
load point. 


2. Mount the media containing 0S/32 and wait until the READY 
light comes on. 


3. Enter the 50 sequences: 


DT A-5O-ADD Address location X'‘'50° 
DTA-D500-WRT | 

DT A-OOCF-WRT 

DTA-4300-WRT 

DITA~OO080-WPT 


4. Enter into memory starting at location X°78* the device 
number and output command of the device containing the 
BOOTLOADER: 


DIA-78-ADD Address location X'"78° 
0294 . . Teletype 
0399 High-speed paper tape 
reader 
71399 High-speed reader/punch 
woe Y5A14 MRE Tape cassette (deck 0) 
55A 1, Tape cassette (deck 1) 
85A4 Magnetic tape (800 bpi) 
C5A 1 Magnetic tape (1600 bpi) 


5. Enter into memory starting at location X'°7A" the device 
number and device code of the device containing OS/32: 


DTA-7A-ADD ; Address Location X'7A‘ 
C631 . 2-54b disk 
C633 10MNb removable disk 
1C 73 33 10M%b fixed disk 
FC34 “HOMb disk 
, DEAS PP CS5 OR RT ; MSH80 disk 
C36 MSN300 disk 
137 Floppy disk 
8540 Magnetic tape (800 bpi) 
C541 Magnetic tape (1600 bpi) 
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6. 


10. 


11. 


Enter into memory starting at location X'7C*° the controller 
and SELCH addresses of the device containing OS/32: 


DIA-7C-ADD Address location X*7C* 
R6FO 2.5Hb disk 
BEFO 10Mb disk 
BFC “HOHb disk 
FBFO . MSM80 disk 
DTA“ epro/ WRT NSM300 disk 
nno Floppy disk (nn=drive 
nunber) 
nnFO Magnetic tape (controller 


included) nn=drive number 


If loading from disk, enter into memory at location X'7E" the 
extension field of the CS/32 fd (X*OOO'-X‘FFF'): 


CTA-ext-WRT 


Initialize machine malfunction rpodunters by entering: 


DIT A-84-ADD Address location X‘'84’" 
DTA-5000-WRT Set pointer to 5000 


DTA-6000-WRT set pointer to 6000 


If loading from disk, disable the write-protect switch on the. 
disk drive. 


Initialize the processor and start executing at location 
X‘'SO* by entering: . 


INI-CDTA-50-ADD-RUN 


When loading is completed, the OS/32 id and license or 
contract are displayed on the system console: 


OS /3Z2nn-uuevVVVVVVVV LICENSE x-xxxx-XxXxx-X 


nn is a decimal number indicating the 
revision level. 
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uu ena, PE: is a decimal number indicating the 
update level. 


VVVVVVV is an 8-character alphanumeric 
string indicating the user version 

number. 
X-XXXX-XXXK-X is a series of alphanumeric 


characters identifying the license 
or contract of the system. 


2-3.4% BOOTLOADER Error Check Procedure and Error Codes 


If the 0S/32 id is not displayed on the syStem console within 
several minutes after initialization or zeros are not displayed 
on the display panel, follow this procedures . 


1.6 


2e 


36 


Ensure that the BOOTLOADER device is turnei on and is online 
to the systen. " 


Ensure that the disk's READY light is on. 
Ensure that locations X‘*7A* through X°7D*:- contain a device 
address, device code, controller address, and SELCH address 


corresponding to the current hardware configuration. 


Ensure that the system console is turned on and is online to 
the systen. 


Check the PSW status for a nonzero value. 
If the error is not detected after performing steps 1 through 
5, a hardware error may exist. Check the display panel for 


a BOOTLOADER error code (Table 2-3) or a system crash code 
(Appendix D). 


Ensure that the console device configured in the system is 
correct for the specific hardware configuration. 


Load a different copy of the BOOTLOADER. 
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TABLE 2-3 BOOTLOADER ERROR CODES - 


oe me wee ans ee Oe Oe OP ee me Oe eS Om ee On ew om a ee eee Om om SE Be ew Ee ee ew oe ee me om owe et em ae am oe ow oe aw 


| ERROR ] | 
| CODE | MEANING 
| Se ae a ee ee a eg at mee ee ee ee { 
|-1 | No contiguous file having a name starting | 
| {| with the characters OS32 was found, or no | 
| | OS32xxxx filename with the correct extension | 
| {| was found. | 
I | | 
} 2 {| Status error for a 2-5Mb or 10Mb disk | 
| | (device unavailable) occurred. | 
| | | 
} 3 {| Status error for a 2.5Mb or 10Mb disk (seek jf 
| | incomplete, not ready) occurred. ee | 
| | | | { 
} 4 {| Status error for a 4YOMb, MSH80, or MSM300 | 
| | disk (unsafe, not ready, device unavailable) | 
| | occurred. | 
I { | 
{| 5 | Status error for a 4OMb, MSM80, or MSM300 | 
| | disk (unsafe, seek incomplete, or not ready) | 
| | occurred. | 
| | | 
| 6 | Data transfer error occurred; for example, | 
| { data parity error. j 
I l | 
| 7 | Operating system image found larger than | 
| I | i 


available memory. 


— oe ee et oe ee ee oe ee ey ee ee ee eee ee ee oe ee ee ee ee ee ee ee ee ee oes eee ee ee ee ee ee ee ee toe 


Loading 0S/32 Using the LSU 


ee Ee ee 


oo ee ee ee ow ee om ane on om OF me ome oe 


2.3.5 

To load OS/32 from a contiguous disk file using the LSU, follow 
this procedure: . 

1. Turn the LSU on/off switch to on. 

Ze Mount the disk volume or tape containing 05/32 and wait for 


the READY light to come on. 
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3. Enter into memory starting at location X‘'7A‘ the device 
' address and device code of the device containing 05/32: 


DTA-7A-ADD 


DTA WRT 
4. Enter into 
controller and SELCH 
0S/32: 
B6FO). 
[BEF O 
BFO 
FBFO 
DTA \ FBFO -WRT 
| nnoo 
nnFko 


5. If loading from disk, enter into memory starting at 


“memory starting at 


addresses 


Address Location X°7A* 


2.5Mb disk 

10Mb removable disk 
10Hb fixed disk 

uLONb disk 

MSH80 disk 

MSMN300 disk 

Floppy disk 

Magnetic tape (8090 bpi) 
Magnetic tape (1600 bpi) 


location X‘7C" the disk 
of the device containing 


2-5Mb disk 
54b disk 
HOMb disk 
MSM80 disk 


-MSM300 disk 


Floppy disk (n=drive 
number) 

Magnetic tape (controller 
includeid) nn=drive number 


location 


X*7E* the extension field of the OS/32 fd (X'000' to X'FPFF"): 


. DTA-ext-WRT 


6. If loading from disk, 


Switch. 


7. Initialize the processor and load 0S/32 by pressing 


key. 
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disable 


the 


hardware write-protect 


the INI 


8. After the LSU loads OS/32 into memory, the OS/32 id and 
license or contract are displayed on the system console: 


OS/32nn-uUuueVVVVVVVV LICENSE x-xxxx-XXxXX-X 
0S/32 is the standard OS/32 fd. 
nn | is a decimal number indicating the 


revision level. 


uu is a decimal number indicating the 
update level. 


VVVYVVVVV_. is an 8-character alphanumeric 
String indicating the user version 
number. 

XM~XXXX~-XXXX-X is a series of alphanumeric 


characters identifying the license 
or the system. 


9. Turn the LSU on/off switch to off. 


2.3.6 LSU Error Check Procedure and Error Codes 


If the OS/32 id is not displayed on the system console within 
several minutes after initialization or zeros are not displayed 
on the display panel, follow this error check procedure: 


1- Ensure that the LSU on/off switch is on. 


26 Ensure that the READY light on the disk drive containing 
0OS/32 is on. 


ae Fnsure that locations X‘'7A" through X°7D° contain a device 
address, output command, controller address, and SELCH 
address corresponding to the current hardware configuration. 


u. Ensure that locations X'7JE’*® and xX'7F* contain the correct 
0OS/32 fd extension. 


oe Ensure that the system console is turned on and is online to 
the system. 


6. Check the PSH status for a nonzero value. 


7. If the error is not detected after performing steps 1 through 
6, a hardware error may exist. Check the display panel for 
an LSU error code (Table 2-4) or a system crash code 
(Appendix D). 


8. If a system failure code is not displayed on the display 


panel, check the hardware configuration for the system 
console device. ; 
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TABLE 2-4 LSU ERROR CODES 


No contiguous file having a name starting with 
the characters 0532 was found, or no OS32xxxx 
filename with the correct extension was found. 


A 2.5Mb or 10Mb disk is unavailable. 


A 2.5MNb or 10Mb disk is unsafe, not ready, or 
unavailable. 


A GOMb, MSM80, or MSM300 disk is unsafe, not 
ready, or unavailable. . 


A 4OMb, MSM80, or MSM300 disk is unsafe, not 


ready, or seek incomplete. 


Data transfer error occurred, 


The size of OS/32 is larger than the memory in 
which it is to be located. 


LOADING OS/32 FOR PERKIN-ELHER 3200 SERIES SYSTEMS 


The starter s 
Or contiguous disk file by the LSU. 


ystems or OS/32 can be loaded from a magnetic 


Qe. 4 Loading 0S/32 Using the REL Loader 


To load 0S/32 object format, follow this procedure: 


1. 


2s 


Mount the media containing the REL loader and position it 


load poin 
Turn key 


Enter the 


a50 

=D500 
=OOCF 
=4300 
=0080 


tie 
to on. Depress HALT/RUN to obtain prompt. 


50 sequence: 
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tape 


at 


He 


10. 


Enter into memory starting at location X‘*78’° the device 
number and output command of the device containing the REL 
loader: : 


a78 Address location X°78° 
=0294 Teletype reader 
4=0399 High-speed paper tape 
- yeader 
=1399 High-speed reader/punch 
=45A14 Tape cassette (deck 0) 
=55A1 . Tape cassette (deck 1) 
=85A1 Magnetic tape (809 bpi) 


=C5A1 Magnetic tape (1690 bpi) 


Clear the PSW by entering: 


Io 


Initialize machine malfunction pointers by entering: 


a8 4 | ' Address location X'84!° 


=5000 — — Set pointer to 5090 
=6000 Set pointer to 6000 


If the processor is equipped with an LSU, the LSU must be 
off. 


Initialize the processor and Start executing at location 


X*50° by entering: 


a50 
< 


The REL loader starting address is displayed. 
If OS/32 is not on the same media as the REL loader, load the 
media containing OS/32 and enter into Jlocation X'78° the 


device number and output command of the device containing 
OS/32. See step 3. 
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11.2 If the device containing 0OS/32 is magnetic tape, the SELCH 

_ address must be specified in location X*7D*. If the device 

containing OS/32 is not a tape, OO must be specified in 
location K°7D*. 


amc 7 Address location X'7C'_ 
=00F 0)’ = SELCH X‘FO" 

=00F 1 SELCH X'F1" 

=0000 No SELCH 


12. Specify the number of filemarks to skip, and execute the REL 
loader to load OS/32 by entering: 


aTE Address location X*7E* 
=00nn . nn=number of filemarks 
arel adr | Address REL loader 


starting address 
< 


13. When loading is completed, the OS/32 ii and license or 
contract are displayed on the system console: 
OS/32nn-uu-evVVVVVVV LICENSE x-xxxx*+XxxXx-Xx 
nn is a decimal number indicating the 
revision level. : 


uu is a decimal number indicating the 
update level. 


VVVVVVV is an 8-character alphanumeric 


string indicating the user version 
numbere 
¥-2EXKOREKK is a series of alphanumeric 


characters identifying the license 
Or contract of the system. . 


204.22 REL Loader Error Check Procedure and Error Codes 
Tf the HAIT light does not come on and the OS/32 revision id is 
not displayed on the System console, follow this error check 


procedure: 


Fs Ensure that the device containing the REL loader is turned on 
and is online to the sySsSten. 


i Ensure that the device containing the ner loader is correctly 
positioned. 
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2-16 


— oo. 
— =e 


NORMAL END 


CKSM or PARITY ERR 


SEQ ERR A sequence error occurred; retry 
load. OS/32 may be defective or 
inconplete. , 

ADDR ERR An attempt to load over the loader 


REF-DEF ERR 


DEV ERR Device is unavailable or is not 
assigned to the correct file. Check 
the device address. 

CONFIG ERR SELCH specified is incorrecte Check 
device address. 

EOF ERR End of file waS encountered; retry 
load. 

A load error occurred because an 


ILL LOADER ITEM ERR 


Ensure that the data entered in the appropriate -OGSELORS : is 
correct. poe 


Load a different copy of the REL loader. 
If the error is not detected after performing steps 1 through 
4, a hardware error might exist. Check the system console 


for the REL loader messages (Table 2-5) or system crash coles 
(Appendix D). 


TABLE 2-5 REL LOADER MESSAGES 
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The load terminated normally. 


A checksum error occurred. Press RUN 
to reread. . 


occurred; retry. 


An REF-DEF chain loop occurred; retry. 


improper control item nn was detected. 
Correct the control item and been is 
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2.453 Loading 0S/32 Using the 2kb LSU 


To load OS/32 image format from disk or magnetic tape using the 
2kb LSU, follow this procedure: 


1- Mount the media containing O0S/32. If OS/32 is on a disk 
device, press the START switch and wait for the READY light 
to come on. If OS/32 is on magnetic tape, position the tape 
at load point. 


2. Turn the LOCK/ON/STANDBY key to the ON position. — 
3. Press the IPL ENABLE/DISABLE switch to ENABLE. 


4. Initialize and load the 2kb LSU Bootloader program by 
pressing the INIT switch. 


After the LSU program is initialized and loaded, the following is 
displayed on the system console: 


3200 LSU LOADER Rnn-uu 
DEVS 
MG85 
MGC5 
DSSR 
DS5F 
DS67 
D256 
FLPY 
OTHR 


In the above LSU id, the variables nn and uu represent the 
following: 


nn | is a decimal number indicating the revision 
level. 

uu is a decimal number indicating the update 
level. 


After the device names are displayed on the system console, the 
LSU respondsS with the following prompts. All responses to 
prompts are lowercase to indicate that they ara specified by the 


uSeLe Lf an error is made when entering a response, press the 


BREAK key to discontinue the response and restart the loader. 
This causes the LSU id, followed by the device names, to be 
displayed on the system console again. 
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DEVICE=xxxx 


xexx - is a 1- to 4-character string indicating the 
Mame of the device containing OS/32. If the 
user-specified device nnenonic was not 
displayed on the system console whan the LSU 
was initialized, enter the letters OTHR. Sea 
Table 2-6 for a list of device descriptions. 


If a magnetic tape device is specified as the response, the tape 


is automatically rewound, and this prompt is displayed on the 
system console: 


FILEHARKS=xxx 


XxX is a 1- to 3-digit decimal number from 9 
. through 255 indicating the number of filemarks 
to skip to load the OS/32 file. When the 
number of filemarks is entered, followed by a 
carriage return, the 2kb LSU loads 05/32. 


If a disk device is specified as the response, this prompt is 


displayed on the system console with the volume name of the disk: 
VOL=VVVV,FILE=filename.ext 


filename.eext is the OS/32 filename and extension. After 
the OS/32 filename ani extension are entered, 
followed by a carriage return, the LSU toads 
OS/32. 


If the letters OTHR are specified in response to the DEVICE= 
prompt, these prompts are displayed on the system console one at 
a time: 


DEV#=nnn 

nnn is a  1- to 3-digit hexadecimal number 
indicating the device address of the device 
containing OS/32. 

CODE=cc 

cc is a 2-digit hexadecimal number indicating the 


device code of the device containing 95/32. 
See Table 2-6 for a list of device codes. 
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CTLR=nmm 


nmm 


SLCH=sss 


SSS 


represents a i- to 3-digit hexadecimal number 
indicating the controlier address of the disk 
device containing 08/32. This prompt is not 
displayed if the device code specified a 
magnetic tape device. 


represents a 1- to 3-digit hexadecimal number 
indicating the SELCH address of the magnetic 
tape or disk device containing 0S/32. This 
prompt is not displayed if the device code 
specified a floppy disk device. 


is a decimal number indicating the spindle 


containing the floppy disk from which the 


 O0S/32 is to be loaded. This prompt is 


displayed only if the device code indicated a 
floppy disk device... 


TABLE 2-6 PERKIN-ELMER STANDARD CONFIGURATIONS SUPPORTED BY LSU 


a gre ee em ae ee aes ee ee ee ee em we 
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i | | | CON- | 

| DEVICE | DEVICE {| DEVICE | DEVICE | TROLLER | SELCH 
| NAME { DESCRIPTION | ADDRESS | CODE | ADDRESS | ADDRESS 
| SS SS eS SS SS SS SSS RS SSS SSS SS SSS SS SS SS SS SS SS SS SSS = 
} NG85 } 800 BPI mag { 85 } 40 ] N/A | FO 

| | tape { | { i 

| | | 

| MG85 {1 71600 BPI mag {| C5 { 41 | N/A |} FO 

| | tape | | | | 

| | | } , | 

|} DSSF } 5Mb disk - as Ot } 32 {| 86 | FO 

| fixed | | | | 

| | | | | | 

j DS5R | 54b disk - { C6 { 33 {| B6 {| FO 

| } Removable { | ] | 

| | | | | 

} DS€é7 |} 67%b disk } FC | 35 | FB | FO 

| | | 

| D256 } 256Nb Disk j} FC } 36 {| FB } FO 

| | { d | | 

i BP EPY { Floppy disk 1 64 { 37 {9 | NZA 


ee ee 
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3.1 2kb LSU Messages 


FILE NOT FOUND 


indicates that the user-specified fd does not exist or is not 
contiguous. 


IOERROR CNFG 


indicates that an I/O error occurred because the hardware 
configuration does not correspond with that specified by the 
uS@L. 


IOERROR DU 


indicates that the user-specified device is unavailable. 


IOERROR UNRE 


indicates that the I/O error that occurred is unrecoverable. 


MEMTST ERR nnnnnn 


2e4. 


indicates that an error occurred during a memory test before 
OS/32 was loaded. The faulting memory location is at nnnnnn.e 
Load an OS/32 with a size 2652 bytes less than location 
nmnnnonn to allow more room for the loader; otherwise, repair 
MeMOry » 


4% Loading OS/32 Using the 8kb LSU 


To load OS/32 image format fron disk or magnetic tape using the 


8kb 


1. 


LSU Bootloader Program, follow this procedure: 


Mount the media containing OS/32. If OS/32 is on a disk 
device, press the START switch and wait for the READY light 
to come on. If OS/32 is on magnetic tape, position the tape 
at load point. 

Tucn the LOCK/ON/STANDBY key to the ON position. 

Place the IPL ENABLE/DISABLE switch in the ENABLE position. 


Initialize and load the 8kb LSU Bootloader Program by 
pressing the INIT switch. : 
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After the program is initialized and loaded, the following is 
displayed on the system ccnsoales: 


BASIC TEST COMPLETE 
3200 8KB LSU BOOTLOADER Rin-au 
DEVICE 

G&S 

NGCS 

NC62 

DS5R. 

CSSE. 

DS67 

D256 

NM68 

MMO1 

MM67 

C13R 

C13F 

CuOF 

C67F 

FLEY 

OTHR 

DEVICE= 


After the Bootloader Program is loaded, processor capabilities 
are tested by the Basic Confidence Test. If this test passes, 
the following message is displayed: 


BASIC TEST COMPLETE 


If this test fails, a message is displayed. See Section 2.4.4.2. 
The Basic.Confidence Test also performs a’ checksum on the data 
read from the 8kb LSU's PROMS. If the checksum calculated is 
incorrect, the following message is displayed and the program is 
terminateds 


CHECKSUH ERROR 


If a checksum error occurs, execute Test 1 of the LSU Support 
Program. Test 1 tests the contents of the PRONs fer accuracy 
against an error-free bootlcader program. If the contents of the 
PRCWS are correct, reinitialize the 8kb LSU Bootloader Program. 
Tf a checksum error reoccurs, the problem might be hardware 
related. 
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After the Basic Confidence Test message is displayed, the 
following program id is displayed: 


3200 8KB LSU BOOTLOADER Rnn-uu 


nn is a decimal number. indicating the revision 
level. 

uu is a decimal number indicating the update 
level. : 


After the LSU id is displayed on the system console, the OS 
bootable. device menu is shown. See Table 2-7 for a list of 
Perkin-Elmer 8kb LSU supported device names, descriptions, and 
configurations. 


TABLE 2-7 8KB LSU SUPPORTED DEVICE NAMES AHD CONFIGURATIONS 


Removable 


| | | coN- | | 
| LEVICE | DEVICE j CEVICE | DEVICE { TROLLER | SELCH ; 
| NAME | DESCRIPTION {| ADDRESS | CODE | ADDRESS | ADDRESS | 
J HSS SSS SSS SESS SSG SSS SSS antes Ses esse Sess se esses Ses sssSssTass | 
| MG85 |} 800 BPI Mag 1 85 | 40 | N/A | FO | 
| | Tape | | | | | 
| MGC5 { 1600 BPI Mag | C5 1 41 1 N/A | FO { 
| {| Tape | [ i | i 
| MG62 | 6250 BPI Mag | 85 | 68 1 N/A { FO { 
] | Tape | | | [ { 
{ DSSR 1 5 Mb Disk - | C6 | 33 | B6 1 FO | 
| {| Removable | ae | | | 
| DS5SF | 5 Mb Disk - } C7 } 32 | B6 | FO | 
| | Fixed l i | bs | 
| DS67 | 67 Mb Disk | FC } 35 | FB | FO | 
| D256 | 256 Mb Disk | FC | 36 | FB | FO { 
|} MN68 | 68.7 Mb Disk | FC | 38 | FB | FO i 
| [= ED | | | | i 
{ | Fixed & Head |] | i | | 
| |} Per | | [ | { 
| | Track | | 1 | | 
| MMO | 7-6 Mb Disk - | FC } 39 | FB | FO i 
| | MMP I | | | | 
| {| Head Per I | | | | 
| | Track | | i | | 
| MM67 | 67-2 Mb Disk | FC | 3A { FB | FO { 
| - MMD | | | | 
| Fixed | | [ 7 | 
| C13R } 13-5 Mb Disk | FC | 3B | FB | Fo | 
| b = CHD | | { | | 
| | | | | | | 
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TABLE 2-7 8KB LSU SUPPORTED DEVICE NAMES AND CONFIGURATIONS 
(Continued) . 


| [ | | 4 |  CON- | | 
| DEVICE | DEVICE | DEVICE | DEVICE {| TROLLER | SELCH | 
| NAHE | DESCRIPTION } ADDRESS | ‘CODE | ADDRESS | ADDRESS | 
| Sm mmr mst sss Sierra) Guat’ Seek eaten are’. toegt nee uane (amen sas eae’ ey gee ee ae SSS SSeS SSS SS SSS SS SS SS SS SSS | 
]| C1i3F } 13-5 Mb Disk | FC { 3c {| FB { Fo | 
| | - CHD | | = | 
| | Fixed | i i | | 
| C4OF | 40.4 Mb Disk | FC | 3D {| FB | FO { 
| | - CMD | | | | 
{ | Fixed { { | l | 
| C67F {| 67.3 Mb Disk | FC } 3E | FB {| FO | 
| - CMD | —— | | | 
| | Fixed | | | | i | 
| FLPY { Floppy Disk } C1 | 37 {| N/A | N/A { 
N/A = Not applicable 
The program then displays the following prompts. The responses 


shown are lowercase to indicate that they are specified by the 
user. If an error is made when entering a response, a correction 
can be made in one of three ways: 


1- Press the BACKSPACE key or CIRL H keys to bring the cursor to 
the character in error, 


2- Press the CTRL X keys to delete the entire line, or 


3-e Press the BREAK key to restart the program. 


>DEVICE=dddd 


dddd is a 4Ycharacter string indicating one of the 
supported devices listed in the 8kb LSU device 
MENU» Configurations for these supported 


devices are automatically represented in the 
system and are listed in Table 2-7. If a 
unique device configuration that differs from 
the configurations presented in Table 2-7 is 
desired, entec OTHR to the DEVICE= prompt. 
The type of device entered in the DEVICE= 
prompt determines which of the following four 
prompt sequences is issued: 
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Mag Tape Device 
If an 8kb LSU supported magnetic tape device is spezified as 


a response, the following prompt is displayed on the systen 
consoles: 


>FILEMARKS=xxx 


xXx is a 1- to 3-digit decimal number from 0 
through 255- This number represents the 
number of filemarks to skip.to load the 0OS/32 
file. When the number of filemarks is 


entered, followed by a carriage return, the 
8kb LSU program loads 0S/32. 


Hard Disk Device 


If an 8kb LSU supported disk device name is entered as a 
response, the following prompt is displayed on the systen 
consoles: 


>VOL=VVVV,FILE=filename.ext 


VVVV is a i- to S-character volume name of 
the disk containing  0S/32. The 
Bootloader program reads and displays 
the existing volume name to the system 


console. 

filename.ext is a  11- to 8-character filenane, 
followed by a t- to 3-character 
extension. After filename.ext is 
entered, followed by a carriage 
return, the 8kb LSU program loads 
0S/32. 
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3. Floppy Disk Device 


If FLPY is entered as a response, the following prompt is 
displayed on the system console: 


>DRV#=n 


n is a decimal number fron 0 through 3 
specifying the spindle containing the floppy 
disk from which the 0S/32 is to be Iloadad. 
After the spindle number is specified, the 
following prompt is displayed:: 


>VOL=VVVV, FILE=filename.ext 


VVVV is a i- to 4-character volume name of the 
floppy disk containing 05/32. The 
Bootloader progran reads and displays the 
existing volume. to the system console. 


filename.eext is a 1- to 8-character filename, followed 
by a I~ to 3-character extension. After 
filename.ext and a carriage return is 
entered, the Bootloader program loais 
OS/32. 


ue. Other 


A response of OTHR to the DEVICE= prompt allows the user to 
specify a device address other than that listed in Table 2-7 
for a particular device. The folloying prompt sequente is 
displayed on the system console: 


>DEV ADDR=aaa 


aaa isa 1- to 3-digit hexadecimal number 
indicating the address of the device 
containing OS/32. 


PDEV CODE=cc 


cc is a 2-digit hexadecimal number indicating 
the code of the device from which the 05 
is to be loaded. The device codes listed 
in Table 2-7 are those used for 8kb LSU 
supported device names. The device code 
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entered indicates the type of device that 


contains the OS. The next prompt 
displayed in the prompt sequence is 
dependent upon the type of device 


indicated by the device code entry. 


>CTLR ADDR=mmm 


mmm 


isa 1- to 3-digit hexadecimal number 
indicating the controller address for the 
device from which the O5 is to be loaded. 
If the device is a magnetic tape ora 
floppy disk, this prompt is not displayed. 


>SLCH ADDR=sss 


sss is a 1- to 3-digit hexadecimal number 
indicating the SELCH address. If the 
device is a floppy disk, this prompt is 
not displayed. 


>FILEMARKS=xxx 


XXX 


>DRV#=n 


is a 1- to 3-digit decimal number from 0 
through 255. This number represents the 
number of filemarks to skip to load O0OS/32. 
This prompt is displayed only if the 
device code entered indicates a magnetic 
tape device. x 


is the decimal number specifying the 
spindle containing the floppy disk fron 


which the OS/32 is to be loaded. This 


prompt is displayed only if the device 
code indicates a floppy disk device. 
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24.4.1 Examples of Loading OS/32 From Different Devices 
© Loading O0S/32 from an 8kb LSU supported magnetic tape device: 


BASIC TEST COMPLETE 
3200 8KB LSU BOOTLOADER Rnn-uu 
HG85 
MGC5 
MG62 
DSSR 
DSSF 
DS67 
D256 
MM68 
MHO1 
MM67 
C13R 
Ci3F 
C4OF 
C67F 
FLPY 
OTHR 
DEVICE=NG85 
FILEMARKS=2 


The above example, followed by a carriage return, loads 29S/32. 


® Loading OS/32 from an 8kb LSU supported disk device: 


BASIC TEST COMPLETE 

3200 8KB LSU BOOTLOADER Rnn-uu 
“MG85 | 
MGC5 

MG52 

DS5SR 

DS5F 

DS67 

D256 

MM68_ 

MMO 1 

MM67 

C13R 

C134 

CUOF 

C67F 

FLPY 

OTHR 

DEVICE=DS5R 

VOL=MT32, FILE=0S3220.KIR 


The above example, followed by a carriage return, loads OS/32. 
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| © Loading OS/32 from an 8kb LSU supported floppy disk: 


BASIC TEST COMPLETE 
3200 8KB LSU BOOTLOADER Rnn-uu 
NG85 | 
NGC5 

MG62 

DS5R 

DS5F 

DS67 

D256 

MN68 

MMO1 

MM67 

C13R 

C13F 

C4OF 

C67F 

FLPY 

OTHR 

DEVICE=FLPY - 

DRV#=1 | 

VOL=MT32, FILE=0S3220.KIR 
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1 The above example, followed by a carriage return, loads OS/32.. 


| @ Loading 0S/32 from an 8kb LSU supported disk device that has 
| a nonstandard configuration: 


BASIC TEST COMPLETE 
| 3200 8KB LSU BOOTLOADER Rnn-uu 
r NG85_ 

| MGC5 

MG62 

DS5R 

| DSSF 

| DS67 

! D256 

| MN68 

| MMO1 

{ MM67 

| C13R 

| C13F 

C4uOF 

CO67F 

FLPY 

| OTHR 

| DEVICE=OTHR 

| DEV ADDR=EC 

DEV CODE=35 

CTLR ADDR=EB 

l SLCH ADDR=FA 
VOL=NT32, FILF=0S3220.KIR 


| The above example, followed by a carriage return, loads 05/32. 


bho 
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es Loading OS/32 from an 8kb LSU supported magnetic tape device 
that has a nonstandard configuration: j 


BASIC TEST CONPLETE 
3200 8KB LSU BOOTLOADER Rnn-uu 
HG85 

NGC5 

MG62 

DSSR 

DS5F 

DS67 

D256 

MM68 

NMO1 

MM67 

C13R 

C13F 

C4OF 

C67F 

FLPY 

OTHR 
DEVICE=OTHR 
DEV ADDR=85 
DEV CODE=40 
SLCH ADDR=FO 
FILEMARKS=2 


The above example, followed by a carriage return, loads 0S/32. 


@ Loading OS/32 from an 8kb LSU supported floppy disk device 
that has a nonstandard configuration: 


BASIC TEST COMPLETE 
3200 8KB LSU BOOTLOADER Rnn-uu 
MG85 
MGC5 
MG62 
DSSR 
DSSF 
DS67 
D256 
MM68 
MMO14 
NM67 
C13R 
C13F 
CSOF 
C67F 
FLPY 
OTHR 
DEVICE=OTHR 
DEVICE ADDR=C2 
DEVICE CODE=37 
DRV#=1 
VOL=MT32, FILE=0S3220.KIR 


The above example, followed by a carriage return, loads 0S/32. 
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24.4.2 8kb LSU Hessages 

The following messages can be generated if errors occur using the 

8kb LSU: 

BASIC CONFIDENCE TEST ERRORS 

CHECKSUM ERROR 

CANNOT CLEAR PSW 

EPSR ARGUMENT 00000001, L FLAG NOT SET 

EPSR ARGUMENT 0000 0001, ALSO SET C, V, OR G 

EPSR DOESN'T PROPERLY UNLOAD PSW 

LA---RX1 FAILURE 

LA~--RX2 FAILURE 

THI---CC NOT CLEAR 

" THI---1ST OP REGISTER CHANGED 

THI---CC NOT SET 

OR---INCORRECT RESULT 

NR---INCORRECT RESULT 

SR---INCORRECT RESULT 

EXBR---INCORRECT RESULT 

SRLS---INCORRECT RESULT 

_ MHR---INCORRECT RESULT 

DH~-~INCORRECT RESULT 
If any of the above BASIC CONFIDENCE TEST error messages 
appear, except CHECKSUM ERROR, the user should contact his 
service representative. 

ITOERROR DU 
The user-specified device is unavailable. 

IORFRROR UNRE 


The I/O error that occurred is unrecoverable. 
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IOERROR CONFG 


An I/O error occurred because the hardware configuration does 
not correspond with that svecified by the user. 


FILE NOT FOUND 


Uceeesueeieies file SSP CELerOr does not exist, or file is not 
contiguous. 


_ MEMTST ERR nnonnnn 


An error occurred during a memory test before 9S/32 was 
loaded. The faulting memory location is at nnnnnn. 


DISC NOT INITIALIZED 


Disk pack (fixed or removable) is not properly initialized. 


2.5 MEMORY CONFIGURATION ERROR 


When a memory configuration error is detected at. systen startup 
time, the following message is displayed on the system console: 


MEMORY CONFIGURATION ERROR xx BLOCK yy 
MEMORY ERROR RECORDING DISABLED. 


wheres: 
xx contains one of the following codes: 

- 01 indicates error occurrei ducing 
initial clearing of error logger 
status bits. 

- 02 indicates error occurred: during 
verification of controller address 
range. 

- 03 indicates error occurred during 
verification of memory interleaving. 

- UN indicates memory error recording was 
‘Specified at sysgen but the 
MCONFIG.OBJ file was not included in 
sysgen. Occurs only on systems 
generated using CUP RO6. 


YY specifies the memory block where the error was 
detected. ; 
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Errors 01, O02, or 03 can result from improper specification of 
physical memory at sysgen time or a hardware malfunction. If an 
error occurs, check the memory contiguration statements used at 
sysgen3; if no incorrect statements are present, check the 


‘hardware using the appropriates hardware diagnostic. 


NOTE . 


Disabling the memory error recording does. 
not interfere with the operating systen’s 
ability to operate. However, memory 
errors will not be recorded. | 


2-6 MODIFYING 0S/32 FOR OTHER PERIPHERAL CONFIGURATIONS 


Poth starter systems are configured with standard device numbers. 
If your particular configuration is not Standari, these 


“procedures can be used to change device addresses after the 


appropriate starter system is loaded. 


2.6.1 Modification of the Console Device Address 


To modify the address of the system console device to that of a 
device of Similar attributes (for instance, from TTY D0 DN=02 to 
TTY @ DN=22 or from TTY a DN=10 to Video Display Unit (VDU) 9a 
DN=12), follow this procedure: 


1. Obtain the address of the device mnemonic table (DMT) from 
the library loader map of starter system (entry point DMT). 
2- Add x’ Cc to this address. | 


3. Read from memory the fullword contents specified by this 
address to obtain the device control block (DCB) adiress. 


4%. Add X'1A* to the DCB address. 


Sy Modify the halfword at this address to contain the new 
physical address of the console device. 


6. Press DTA-60-ADD-RUN. The operating system id should be 


displayed at the systen console. 


For Perkin-Elmer 3200 Series processors, enter: 
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To modify the system console from one type of device to another 
(for instance, from TIY 2 DN=02 to VDU ad DN=10), follow this 
procedure: 


Vs Obtain the address of the DMT from the library loader map of 
the starter system (entry point DMT). 


2. Find the address of the current system console by reading 
fullword at ACDHT) + X‘°C*. . 


Be scan down the DNT starting at AC(DHT) + X°190°, every 8 bytes 
for the device mnemonic with the device characteristics 
desired. For example, VDU would be fullword 43525420. 


ue “When found, swap the DCB address in the following fullword 
with that of the system console. : | | 


5. If the device number is not correct, use the preceding 
procedure to modify it. | | 


6-6 Restart operating system at location X"60". 
2-6.2 Modification of Nonconsole Device Addresses 
To modify the address of a nonconsole device, follow this 


procedure: 


1- Obtain the DCB address from the library loader map of starter 
system. Each DCB in the system has an address specified on 
the map. 


Formats: 
DCBdddnn 
Parameters: 
ddd is the device code. 


nn is an index indicating which DCB it 
represents. 
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Example: 


DCBO 1600 is the DCB associated with the 
teletype device (device code = 16). 
It is the first DCB generated for 
this teletype device, hence an index 
of X°O00O‘'. 
2. Add X'1A* to the DCB address. 
‘3. Modify the halfword at this address to contain the physical 


address of the device. The system console should be used to 
perform this modification. For example: . 


BIAS 0 —_ 
MODIFY 1234,0034 


s 


See Chapter 3 for an explanation of the BIAS and MODIFY 
commands. — ; 7 | 
"2.663 Modification of the SELCH Address 


To modify the address of a SELCH, follow this procedure: 


4. Obtain the associated DCB address‘as in Section 2.5.1. 

2- Add X'98" to this address. 

3. Modify the halfword at the resulting location to contain the 
correct SELCH.physical address. The system console should be 
used to perform this modification. 


2-6.4 Modification of the Controller Address 


To modify the address of a controller, follow this procedure: 


1. Obtain the associated DCB address as stated in Section 2.5.2. | 
2 Add X"9A* to this address. 
3% Modify the halfword at the resulting location to contain the 


controller physical address... Use the system console to 
perform this modification. 
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2-6.5 Modification of the Console Device Nane/Type 

Lf the console is a YDU device, rather than a ITY device or vice 

versa, follow this procedure: 

4. Obtain the address of the initial value table from the 
library loader map of the starter system (entry point IYTBL). 

2. Read the two halfwords from memory at this location. The 
contents at this location should be: 


4Q34UF,4E20 (CON in 7-bit ASCII) 


3- Modify these four bytes to contain the desired console device 
name: ) 


4352,5420 (VDU in 7-bit ASCII) 


4. Press DTA-60-ADD-~RUN. The operating system id and License or 
contract number should be displayed on the VDU. For 
Perkin-Elmer 3200 Series processors, enter: ; 


a 60 
> 
NOTE 
This procedure should be followed only 
immediately after system initialization. 
To avoid repeating this procedure for each system initialization, 


the operating system should be patched by OS/32 Patch. 


This procedure assumes.the device addness is correct. Li not, 
perform the procedure to change the address. 
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CHAPTER 3 | 
CONSOLE USE AND OPERATOR COMMANDS 


_ Bo INTRODUCTION 


Communication between the operator and the operating syStem or 
user program is accomplished by an operator command language. 
The operator commands described in this chapter are input to the 
“system via the system console. 
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3.2, 


The 


ALLOCATE COMMAND 


ALLOCATE command is used to create a direct access file or ¢ 


data communications line control block (LCB) for a buffered 
terminal manager. 


Format: 


keys 
CONTIGUOUS, fsize I, 
Y lrecl bsize | isize 
VY INDEX], /\). / 
426 ae & 
Hosoe} 
“leone 
| frre? (bsize keys 
ITA), / | ; 
\ ee loa 9000. 


[ALLOCATE fd, 


Parameters: 


fd is the file descriptor of the device or file 
to be allocated. 


CONTIGUOUS specifies that the file type to be allocated 


is contiguous. 

fsize is a decimal number indicating file size, 
which is required for contiguous files. [t 
specifies the total allocation size ir 


256-byte sectors. This size may be any value 
up to the number of contiguous. free sectors 
existing on the specified volume at the time 
the command is entered. 


INDEX specifies. the file type to be allocated is 
index. 

lrecl is a decimal number specifying tha logical 
record length of an index file or data 
conmunications device. Tt cannot exceed 


65,535 hytes. Its défault is 126 bytes. 
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It may optionally be followed by a slash (/), 
which delimits lrecl from bsize. . 


bsize is a decimal number specifying the physical 
block size to be used for buffering and 
debuffering operations on the index file or 
data communications device. When INDEX is 
specified, bsize represents the blocksize in 
sectors. . When ITAM is specified, bsize 
represents the buffer size in bytes. This 
Parameter cannot exceed the maximum block size 
established at system generation (sysgen). If 
bsize is omitted, the default value is one 
sector (256 bytes). 


isize | is a decimal number specifying the index block 
. size. If isize is omitted, the default value 
is one sector (256 bytes). Like bsize, isize 
cannot exceed the maximum block size 
established at sysgen; and in any case, 
neither operand can exceed 255. 


ITAM specifies that the device to be allocated is 
a data communications device. | 


keys specifies the write and real protection keys _ 


for the file. These keys are in the form of 
a hexadecimal halfword, the left byte of which 
Signifies the write key and the right byte, 
the read key. If this parameter is omitted, 
both keys default to 0. 


Functional Details: 


To asSign an index file, sufficient roon must exist in systen 
space for two buffers, each of the stated size. Therefore, if 
bsize is very large, the file may not be assignable in some 
memory-bound Situations. At sysgen, a maximum block size 
parameter is established in the system, and bsize cannot exceed 
this constant. ; 


A file associated With a nonzero account hRumber cannot be 
allocated from the system console. 


Examples: 


AL JANE.TSK,CO,64 ‘allocates on the system volume a 
contiguous file named JANE.TSK which 
has a total length of 64 sactors 
(16kb) with protection keys of 0. 


AL VOL1:AJM.OBJ,IN,126 allocates on volume VOL1 an index 


file named AJH.OBJ which has a 
logical record length of 126 bytes. 
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AL M300: AJM.BLK,IN,132/4 


AL THISFILE,IN,256/4/2 


AL VO1:AJM.OBJ,IN,126//3 


The buffer size and index block gs 
default to 1 sector an( 
protection keys default to 0. 


allocates on volume M300 an in 
file named AJM.BLK which has 
logical record length of 132 byt 


data block size of 4 Sectors, 
default isize of 1 £4sector. 
protection keys default to 0. W 
this file is assigned, ‘the sys 
must have 2.5kb of available sys 
space for buffers. 


volume 
(bl 
Logi 
a d 
in 


allocates on the system 
index file namei THISFILE 
extension) which has a 

record length of 256 bytes, 
block size of 4 sectors, an 
block size of 2 sectors, 


protection keys of 0. 

in 
has 
byt 


allocates on volume VO1 an 
file named AJM.OBJ which 
logical record length of 126 


The data block size defaults t 
sector, the index block size is 
sectors, and the protection k 
default to 0. “ 
Messages: 
ALLO-ERR TYPE= 
indicates that allocation failed for reasons denoted by fT! 
field. 
FD-ERR 
indicates an invalid fd. 
NODA-ERR 
indicates that direct access support was not included in t 


system at sysgen. 
NOPR-ERR 
indicates 


PARM-ERR 


indicates 


that a required operand is missing. 


an operand syntax error, 


48-030 FOO R 


Oe Be eee ee ed 


323 ASSIGN COHHAND 


The ASSIGN command assigns a device, file, or data communications 
device to one of a task's logical units. 


‘Format: 


ASSIGN lu,fd], 


Parameters: 


lu 


fd 


access privileges 


syvc15 
keys 
z , 
VEC 
NOTE 
Tf the access privileges and keys 
parameters are omitted and VFC is 
specified, the respective positional 
conmas belonging to the omitted 
parameters can also be omitted if 
desired. 
If the access privileges ani VFC 
parameters are specified and the keys 
parameter is omitted, the positional 


comma belonging to the keysS parameter can 
be omitted if desired. 


is a decimal number specifying 


the 


logical 


unit number to which a device or file is to be 


assigned. 


is the file descriptor of the device or file 


to be assigned. 


48-030 FOO ROO 


now ene ew ees we ow come 


an eee ee pee oe om 
e 


access 
privileges 


keys 


is the desired accass privileges. The default 
access privileges are: 

- SRW for contiguous files, 

~ SREW for index files, 

- SRW for devices, and 


- SRO for files with a nonzero account 
number. . 


Signifies the write/read protection keys of 


the file or device to be assigned. 


SVC15 


VFC 


Functional Details: 


Signifies that the specified device is to be 
assigned for SVC 15 access. This option 
pertains to data communications devises only. 
If SVC 15 access is specified, vertical forms 
control cannot be specified. 


specifies the use of vertical forms control 
for the assigned lu. If this parameter is 
omitted, there is no vertical forms control 
for the device assigned to the specified lu. 
If this parameter is specified, SVC 15 access 


cannot be specified. 


Access privileges can be one of the following: 


SRO Sharable read-only 

ERO Exclusive read-only 

SWO Sharable write-only 

EWO Exclusive write-only 

SRW Sharable read/write 

SREW Sharable read, exclusive write 
ERSW Exclusive read, sharable write 
ERW Exclusive read/write 


The command is rejected if the requested access privilege cannot 


be granted. 
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A file with a nonzero account number can only be asSigned with 
access privileges of SRO or ERO. If the access privileges field 
is omitted, a default of SRO is assumed for a file with a nonzero 
account number, and SRW or SREW is assumed for system files. The 
DISPLAY LU command can be used to determine the current access 
privileges of all assigned units. Refer to Section 3.20 for more 
information. : 


When a task has assigned a file, it might want to prevent other 
tasks from accessing that file while it is being used. For this 
reason, the user can ask for exclusive access privileges, either 
for read or write, at assignment time. This protection is called 
dynamic because it is only in effect while the file remains 
assigned. 


A file cannot be assigned with a requested access privilege if it 
is incompatible with some other existing assignment to that file. 
For example, a request to open a file for exclusive write-~-only is 
compatible with an existing assignment for SRO or ERO but is 
incompatible with any existing assignment for other access 
privileges. Table 3-1 illustrates compatibilities and 
incompatibilities between access privileges. 


TABLE 3-1 ACCESS PRIVILEGE COMPATIBILITY 


a a rt ee i ete ere tee rte Re net Nn ee ee ee 


{| ERSW | ERO | SRO | SRW | SHO } EWO | SREW | ERY | 


MN) 
mM 
x 


i Conpatible 
- Incompatible 
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The keys format is a 4-digit hexadecimal number. The left two 
digits . signify the write protection key, and the right two 
digits, the read protection key. If omitted, the dafault is 
0000. These keys are checked against the appropriate existing 
keys for the file or device. The command is rejected if the keys 
are invalid. The keys associated with a file are spezified at 
file allocation time. They can be changed by a REPROTECT command 
or through an SVC 7 reprotect function call. 


If the values of the keys are within the range of X'01° to X°FE‘, 
the file or device cannot be assigned for read or write access 
unless the operator or requesting task supplies the matching 
keyse- If a key has a value of X‘'00°, the file or device is 
unprotected for that access modee Any key supplied is accepted 
as valid. If a key has a value of X'‘FF', the file is 
unconditionally protected for that access moie. I[t cannot be 
assigned for that access mode to any user task (u-task), 
regardless of the key supplied» An unconditionally protected 
file may be assigned to an executive task (e-task), including the 
system manager. 


Some examples of protection keys are shown in Table 3-2. 


TABLE 3-2 PROTECTION KEYS AND THEIR MEANINGS 


oe me ee ee ae or ee ee ee me ee eee 8 ee ee ee ees ee een ee ee re ee ee ee em ee ee ee ere ee ee et we ree ee ee ee ee ee ee ee ee 


| 
{| KEY | KEY | MEANING | 
{| oo | 00 } Completely unprotected { 
| { | l 
{| FF | FF {| Unconditionally protected | 
| | | { 
|} O7 | 90 | Unprotected for read, conditionally pro- | 
| -| {| tected for write (user must supply write | 
| | ] key=X‘'O7') | 
| I | | | 
| FE } A7 { Unconditionally protected for write, | 
| | | conditionally protected for read | 
| | | | 
{| 00 {| FF } Unprotected for write, unconditionally | 
| | |} protected for read . | 
| | | | 
| 27 | 32. | Conditionally protected for both read | 
| | | . | 


and write 


The protection keys of a device can be changed by the systam 
Operator by the REPROTECT command. 


S=e- 48-030 FOO ROO 


An assigned direct access file is positioned at the end of the 
file for access privileges SHO and EWO. It is positioned at the 
beginning of the file for all other access’ privileges. The 
command is retected if the specified lu is assigned and the 
currently selected task is not dormant. To reassign an lu for an 
active task, the lu must first be closed. 


Exanpless 


AS 3,CR:,ERO assigns the card reader to ilu 3 with 
exclusive read only access 
privilege. The keys default to 
0000. 

AS 2,FILE.DAT,EWO . assigns a disk file to lu 2. The 
EWO access privilege causes the file 
to be positioned at the end. New 
records are appended. 

AS 2,TEST.JOB,VFC assigns a disk file to Lu 2e 
Vertical forms scontrol is in use. 
Access privileges and — keys 
parameters are omitted along with 
their respective commas. 

AS 2,TEST.JOB,,,VFC assigns a disk file to lu 2e 

. Vertical forms control is in use. 
Access . privileges ani keys 
parameters are omitted, but 


positional commas are specified. 


AS 2,TEST.~JOB,,00FF,VFC assigns a disk file to Lu fae 
Vertical forms control is in use. 
The positional comma belonging to 
the omitted access orivileges 
Patameter must be specified. 


AS 2,TEST.~JOB,SRO,VFC assigns a disk file to Lu 2° 
Vertical forms control is in use. 
The keys parameter, along with the 
positional comma, is omitted. 


AS 2,TEST.JOB,OOFF,VFC is an invalid assignment because the 
positional comma belonging to the 
omitted access privileges parameter 
must be specified. 


AS 2,TEST»*JOB,SRO,VFC,SVC15 


is an invalid assignment because 
vertical forms control and SVC 15 
access ame mutually exclusive and 
cannot be specified in the same 
assignment. ; 
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Messages: 


ASGN-ERR TYPE= 


indicates 
field. 
field. 
FD-~ ERR 
indicates 
LU-ERR 
indicates 
NODA-ERR 
indicates 


NOPR-ERR 


indicates 


indicates 
PRIV-ERR 

indicates 
SEO= ERR 

indicates 
SPAC-ERR 


indicates 
usSagee 


TASK-ERR 


indicates 


See 


reason 
possible 


noted by the TIYPI 
antries in the TYP! 


the assign failed for 
Appendix B for 


an invalid fd. 

that an invalid lu number or lu was assigned. 
there is no direct access support in the systen. 
an invalid epeeunae 

an operand syntax error. 

an invalid access Sriviaege mnemonic... 

that task was not paused or is dormant. 


the task exceeds established maximum system space 


that there is no currently selected task. 
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3.4 ATTN COMMAND 
The ATTN (attention) command is used to modify the priority of 


the system task that processes operator and command substitution 
system (CSS) commands. 


Formats: 


Parameter: 


n is a decimal number from 2 through 249 
specifying the new priority of the command 
processor task. If n is omitted, the default 
is 2. 


Functional Details: 


The ATTIN command only should be entered when critical real time 
tasks are executing in the foreground. It lowers the priority of 
the task processing system commands, and therefore could delay 
execution of a time-sensitive operator command. This command can 
be entered only from the system console. 


Example: 
ATTN 120 sets the priority of the system command 
processor to 120. 
Message: 
ATTN~ERR 


indicates that n is not a decimal number from 2 through 249. 
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3-5 BFILE COHHAND 


The BFILE command backspaces to the preceding filemark or 
magnetic tapes, cassettes, and direct access files. 


Formats: 
BEILE fd Used for magnetic tapes anc 
cassettes only . 
BFILE fa[,1u] . Used for disc devices only 
Parameters: 
fd is the file descriptor of the device or file 
to be backspaced to a filemark. 
Lu is the logical unit to which the file is 


assigned. 


Functional Details: 


For magnetic tapes and cassettes, only the parameter fd should be 
specified; for direct access files, lu optionally can be 
specified. The account number must be 0 if specified. 


Before entering the format for files, the task must be selectec 
as the current task through the TASK commande 


Exanpless: 
RF MAG2: causes the device MAS2: ee 
backspace one filemark. 
BEF M300: AJM.~OBJ,4 causes file AJ4.OBJ that is assigne: 


to lu 4& on volume M300 to backspace 
. one filemarke 
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Messages: 


ASGN~-ERR TYPE= 


indicates that the file or device could not be assigned for 
the reason noted in the TYPE field. , 


FD-ERR 


indicates that the specified fd has a syntax error or a 
nonzero account number. 


IO-ERR 


indicates that an I/O error or an illegal or unassigned lu 
was encountered. 


LU-ERR 


indicates that lu was not a valid decimal number or was 
greater than maximum lu (maxlu) for the task. 


. NOBC~ERR 


indicates that bulk file command support is not included in 
the operating system. . 


NOPR-ERR 
indicates that no operand was specified. 
TASK-ERR 


indicates that there was no currently selected task, and a 
BFILE command with an lu specified was entered. 
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3.6 BIAS COMMAND 
The BIAS conmand is used to set a bias address for thea EXAMIN 
and FODIFY commands. 
Format: 
address 
BIAS = 
*taskid 
Parameters: 

address is a hexadecimal bias to be added ts th 
address given in any subsequent EXAMINE o 
MODIFY command. If address is omitted, al 
addresses specified in subsequent EXAMINE an 
MODIFY commands are treated as unbiased; the 
are assumed to be absolute physical addresses 

* specifies that the bias is set t9 be th 
physical address of the first location of th 
currently Selected task. If the currentl 
selected task is rollable, specification of 
results in an error. 

*taskid specifies that the bias is set to be th 
physical address of .the first location o 
taskid. If this task is rollable 
specification of BIAS *taskid results ina 
error. The currently selected task is no 
changed. 

Functional Details: 
A BIAS command overrides all previous BIAS commands. Th 
operator should enter a BIAS command if the current value i 


unknown. 
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Examples: 


TA EXAM sets the currently selectei task to 
task EXAM. 
BI * sets the bias to first lozation of 
task EXAH. 
BI *EXAN sets the bias to first location of 
task EXAM. 
Hessages: 
PARM-ERR 


indicates an operand syntax error. 

ROLL-ERR 
indicates BIAS * was entered and the currently selected task 
is rollable, or BIAS *taskid was entered and taskiij is a 
rollable task. 

TASK-ERR 
indicates BIAS * was specified but there iS no currently 


selected task, or BIAS *taskid was entered and no task with 
name taskid exists. 
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3-7 BRECORD COMMAND 


The BRECORD command pbackspaces to the preceding record ¢ 
Magnetic tapes, cassettes, and direct access files. 


Fornats: 

BRECORD fd Used for magnetic tapes ar 

cassettes only 

BRECORD fd[,lu] Used for disk files only 
Parameters: 

fd is the file descriptor of the devize to rf 

backspaced one record. 
Lu is the logical unit to which the file i 


assigned. 
Functional Details: 


For magnetic tapes and cassettes, only the parameter fd should 
specified; for direct access’ files, lu opticnally can 
specified. The account number must be 0 if specified. 


oro 


Before entering the format for disk devices, the task must b 
selected as the current task through the TASK commande 


Examples: 
BR MAG2: causes the device MAS2: t 
backspace one record. 
BR M300:AJH.O8J,4 causes the file AJM.OBJ that i 


assigned to lu 4 on volume M300 t 
backspace one record. 


3-16 7 48-030 FOO RO: 


Messages: 


ASGN-ERR TYPE= 
indicates that the file or device could not be assigned for 
the reason noted in the TYPE field. See Appendix B for 
possible entries in the TYPE field. 

FD-ERR 


indicates that the specified fd has a syntax error or a 
nonzero account number. 


IO~ERR 


indicates that an I/O error or an illegal or unassigned lu 
was encountered. | | 


LU-ERR 


indicates that lu was not a valid decimal number or was 
greater than maxlu for the task. = 


NOBC-ERR 


indicates that bulk file command support is not included in 
the operating systen. 


NOPR~-ERR 
indicates that no Operand was specified. 
TASK-ERR 


indicates that there was no currently selected task when 432 
BRECORD command with an lu specified was entered. 
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3.8 BUILD AND ENDB COMMANDS 


The BUILD and ENDB commands copy data from the commani stream 1 
a device or file (account number must be zero if specified) 


These commands are normally used from a CSS file but can also | 


entered from the system console. 
Format: 


BUILD £d [,APPEND] 


ENDB 
Parameters 


fd is the file descriptor of the device or fil 

| to which data is to be copied. If £14 does no 
contain an extension, .CSS is used as 

default. If a blank extension is desired, th 

period following the filename must be typed 

If fd refers to a direct access file, an inde 

file by that name is allocated with a logica 

record length equal to the sysgened comman 

buffer length, a blocksize of 1, and keys o 

0000. If the specified f1i already exists 

that fd is deleted and a ney fd is allocated. 


APPEND allows the user to append data to an existin 
fd. If the fd does not exist, it i 
allocated. 


Functional Details: 


Lines entered from the console following BUILD are not treated a 
commands, but as data, and are copied to the specified device o 
file until an ENDB is encountered. The BUILD command must be th 
last command on an input line. Further data appearing on tha 
line is treated as comment and causes no action to be taken. Th 
BUILD command can be entered from the console only if no CS 
files are active. It can also be entered from a CSS file. If 

BUILD command is entered at. the console, the prompt .CHDP 
indicates that the system command processor is requesting data. 
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The ENDB command must appear as the first command on adline. Any 
commands following the ENDB on the same command line are 
executed. No error response is possible from ENDB. If ENDB is 
not entered as the first command on the command line, the line is 
copied to the BUILD file. 


Messages: 


ASGH-ERR 
indicates that output file or device could not be assigned 
for the reason noted in the TYPE field. See Appendix B for 
possible entries in the TYPE field. 

FD-ERR 


indicates invalid fd or no index file support. 


IO~-ERR 
indicates that an I/0 error was encountered on output fil2 or 
device. 

SEQ-ERR 


indicates that CSS file is active, BUILD entered from systen 
console. 
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309 CANCEL COMMAND 


The CANCEL command terminates the task as if the task ha 
executed an SVC 3 and terminated with an end of task code of 255 


Formats: | 
CANCEL taskid 
Paraneter: 
taskid is required if the command is entered from th 
aoe console, but is Opetonad if used i 


Functional Details: 


If the task is nonresident, it is removed from the system. Al 
outstanding I/0 is terminated and the task*s logical units ar 
closed. If the task is resident, it is not removed from memory 
Its logical units are not closed, but are checkpointed. Thi 
command can be entered even when the currently selected task i 
dormant. It has no effect on a resident task that has alread 
gone to end of task, unless preceded by an OPTIONS NONRESIDEN. 
command. If preceded by an OPTIONS NONRESIDENT command, it ma: 
be used to remove a task from memory. The normal response ti 
this command is: 


hh:mm:ss TASKID: END OF TASK 255 
Messages: 


PARMN~ERR 
indicates that taskid is missing or task is not loaded. 
TASK-ERR 


indicates that there is no currently selected task. Thi: 
applies to CSS only. 
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3.70 CLOSE CONHAND 


The CLOSE command p 
more files or devic 
logical units. 


Formats: 
lu, [,lu, 
CLOSE 
AL 
Parameters; 
Lu 
ALL 


Functional Details: 


Closing an unassign 
CLOSE command can 
dormant or pausede 


Examples: 
CL 1,3,5 


CLOSE A 


Messages: 


CLOS-ERR 


indicates that 
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ermits the operator to clos2 (unassign) one or 
es assigned to the currently selected task’s 


poeoorlty | 


L 


is a decimal number specifying the lu 
assignments. 


specifies that all logical units of the 
currently selected task are to be closed. 


ed lu does not produce an error message. A 
be entered only if the referenced task is 


closes logical units 1, 3, and 5 of 
the currently selected task. 


closes all logical units of the 
currently selected task. 


close failed for reason denoted by TYPE fiald. 


PARM-ERR 

indicates an invalid or missing parameter. 
SEQ-ERR 
| indicates that task was not dormant or paused. 
TASK-ERR 


indicates that there is no currently selected taske 
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3-11 COHTINUE COHHAND 


The CONTINUE command causes a task that executed a PAUSE 


> mt aay Cue ome eum 


{| CONTINUE | 


at ey ab any eee eek ne 


(SVC 2 


code 1) or that was paused by the operator to resume operation. 


Format: 


CONTINUE [address] 


Parameters 
address is a hexadecimal number that specifies where 
the task is to resume operation. If this 
Parameter is not specified, the task resumes 
at the next sequential instruction following 
the pause. 
Messages: 


PARM-ERR 

Apeteakes an invalid parameter. 
SEQ-ERR 

indicates that task was not paused. 
TASK-ERR 


indicates that there is no currently 
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3-12 DELETE COMMAND 


The DELETE command is used to delete direct aczess files. 
peewee: 

DELETE £d1[,fd2,-0+,/fdn] 
Parameters: 


fd identifies the file(s) to ba deleted. 
Functional Details: 


The file being deleted must not be currently assigned to any 
of any task. This command is not recognized if there are 
direct access devices in the system. A file can only be delet 
if its write and read protection keys are 0 (X'0000°). If t 
keys are nonzero, they can be changed using the REPROTE 
command. ; 


Hessages: 


DELE-ERR& 


indicates that delete failed for reason denoted by fY 
field. 


FD-ERR 
indicates an invalid fd. 
NODA-ERR 


indicates that direct access support is not included in th 
system. 


NOPR-ERR 


indicates that no operand was specified. 
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PRIV-ERR 


write or read protection keys are nonzero indicating that the 
file is currently assigned. 


-DELE error TYPE field responses: 


ASGN 

indicates that 
NAME 

indicates that 
PROT 

indicates that 
VOL 


indicates that 
not marked on, 
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the file is currently assigned to a task. 
the file does not exist. 
read/write protection keys are not 0. 


specified volume is not mounted, volume 
or incorrect volume name was given. 


was 


ones Tam era 
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3.13 DISPLAY ACCOUNTING COHMAND 


The DISPLAY ACCOUNTING command displays to the specifiei’§ fd 
accounting information for the specified task. 


Format: 


taskid fd 
DISPLAY ACCOUNTING — 4. } | i 


Parameters: 


taskid 


fd 


is the task name for which accoun 
information is displayed. If this paran 
is omitted, accounting informatio is lo 
for all tasks. | & 


is the device or file to which accoun 
information is displayed. If this paran 
is omitted, the accounting information 


displayed to the system console. 


Functional Details: 


This command is valid only for systems with accounting supp: 
The time is displayed in the following format: 


hh:mmssss:tt 


hh 
mm 
Ss 


tt 


represents hours. 
represents minutes. 
represents seconds. 


represents tenths of seconds. 


48-030 FOO 


Exanples 


DA ,RCORDEL 
TASK NAWE USER TIME SVC TIME WAIT TIME ROLL TIME ROLLS I/O 
RCORDEL 3:31.46 3.7 45.4 2-0 0 4390 


Messages 


NO ACTIVE TASK(S) FOUND 


indicates no active tasks found in the system. 


NOAC-ERR 


indicates that accounting is not supported for this system. 


FORM-ERR 


indicates a command syntax error. 


PARM-ERR 


indicates an operand syntax error. 


SPAC~ERR 


indicates that required system Space is not available. 


FD-ERR 


indicates an invalid fd. 


ASGN-ERR TYPE= 


indicates that output file or device could not be assigned 
for. the reason noted in the TYPE field. See Appendix B for 


possible entries in the TYPE field. 


I/0-ERR 


indicates that I/0 error was encountered on output file 
device. 
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3-14 DISPLAY DEVICES CGHHAND 


The DISPLAY DEVICES command allows the operator to determine the 
phySical address, keys, online/offline state, and the volume name 
(for online direct access devices) of all devices in the systen; 
to determine the state of error recording for those devices 
supporting the error recording function; and to obtain the names 
of the pseudo devices (created by the system tasks using the 
intercept feature) currently in the systen. 


Formats: 
fd 
DISPLAY DEVICES . - | 
Parameter: 
fd is the file descriptor specifying the file 
(account number must be 0O if specified) .or 
device to which the display is routed. If fd 
is omitted, the display is output to the 
system console. 
Examples: 
D D 


NAME DN KEYS 
NULL 0 0000 

CON 2 0000 

CR 4 0000 

PRT 62 0000 

PTRP 13 0000 

PR 0 0000 SPOL 

SPL 0 0000 SPOL 

VDU1 30 0000 

VDU2 14 0000 

MAG1 85 0000 a 
DSC1 C45 0000 MUD1 PROT CDIR 


DSC2 C7 0000 FIX2 

DSC3 D6 0000 MTM PROT ERC 
DSC4 D7 0000 FIXY ERR=10 

DSCS F6 0000 °#&£«OFF 


D67A FC 0000 V67A CDIR 
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In the DISPLAY DEVICES output, columns 1, 2, and 3 contain the 
device name, device number (address), and keys, respectively. 
Column 4 is only defined for pseudo print (spool) and direct 
access devices. The characters SPOL specify that the devices are 
pseudo print devices used in spooling. 

For direct access devices, column 4 contains the characters OFF 
to indicate that the device is offline. If online, the volume 
hame is output in column 4. For write-protected discs, column 5 
contains the characters PROT. If the secondary directory option 
. is enabled, column 6 contains the characters CDIR. If the 
secondary directory contains the maximum amount of data and an 
entry is made, OVFL is also displayed. 

Error recording information for devices where error recording is 
enabled is displayed in columns 5 and 6. ERC indicates that 
error recording is enabled, but no errors have been detected. 
ERR=n, where nis the number of errors detected, indicates that 


errors have been detected. The value of n represents the total 
number of errors recorded since the device was last marked on. 


Messages; 


ASGN-ERR 


indicates an optional fd could not be assigned; eeg-, fd is 
- assigned for exclusive use already. 


FD-ERR 

indicates an pavaiia fd. 
FORM-ERR 

indicates a command syntax error. 
IO-ERR | | | 


indicates an I/O error was encountered on output devizte or 
file. 


PARM-ERR 


indicates an operand syntax error. 
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| DISPLAY | 

| DFLOAT | 

3.15 DISPLAY DFLOAT COMMAND 

The DISPLAY DFLOAT command displays to the specifiei fd t. 


contents of the double precision floating point registe 
associated with a user-specified task. n.5 


Format: 


DISPLAY DFLOAT Ie 


Parameter: 


fd -is the'file. descriptor specifying the fi 
(account number must be 0O if specified) 
device to which the contents of the doub 
precision floating point registers associat: 
with a user-specified task are displayed. 
fd is omitted, the display is output to t 
system console. 


Functional Details: 


The user-specified task should have been established with t) 
DFLOAT option at Link time. : 


Examples 


PSW 000077F0 OO000E588 
0,2 00000000 00000000 00000000 00000000 


4,6 00000000 00000000 00000000 00000000. 
8,A 00000000 00000000 00000000 00000000 
C,E 


00000000 00000000 000009000 00000000 
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Messages: 


ASGN-ERR 


indicates that optional fd could not be ae tees eege, fil is 
“Sst gned? for exclusive use already. 


FD-ERR 
indicates an invalid fd. 
FORM-ERR | 
‘indicates a command syntax error. 
IO-ERR 


indicates that an I/O error was encountered on output File or 
device. 


NOFP-ERR 


indicates that specified task was not established with the 
DFLOAT option at Link time. . 


PARM-ERR 
| indicates an operand syntax error. 
TASK-ERR 


indicates that no task was specified or user~specified task 
does not exist. 
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3.16 DISPLAY ERRORS COMMAND 

The DISPLAY ERRORS command displays to the user-specified £4 
list of errors that the hardware error logger has detected, ar 
the following additional error recording status: 

e® Status of the error recording function (on or off) 

e Date when error recording was turned on (month, day, year) 

® Time (hour, minutes, seconds) 


® Setting of the error log readout time period (minutes) 


i 


fd is an optional file descriptor specifying 1 
file (account number must be 0 if specific 
or device that receives the summary of 
hardware-logged errorse If fd is omitted, 
summary is displayed to the system console. 


Format: 


DISPLAY ERRORS 4 . 


Parameters 


Examples: 


ERROR RECORDING STATUS REPORT: 
RECORDING STATUS: OFF 

MEMORY ERRORS RECORDED: 

DISK ERRORS RECORDED: 

FILE MANAGER ERRORS RECORDED: 
SYSTEM DETECTED ERRORS RECORDED: 
SYSTEM MILESTONES RECORDED: 
MEMORY ERRORLOG READOUT PERIOD: 


—~CQAQA 090090 


ERROR RECORDING STATUS REPORT: 
RECORDING STATUS: ON 

START DATE/TIME: 05/15/79 14:57:10 
CURRENT ERROR LOG FILE: FIXED: ERR.LOG 


MEMORY ERRORS RECORDED: 0 
DISK ERRORS RECORDED: 2 
FILE MANAGER ERRORS RECORDED: 1 
SYSTEM DETECTED ERRORS RECORDED: 0 
SYSTEM MILESTONES RECORDED: 15 
MEMORY ERRORLOG READOUT PERIOD: "140 
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Functional Details: 


The error counts displayed when a DISPLAY ERRORS command is 
issued represent the total number of errors recorded since the 
error logging facility was last turned on. Turning the. error 
logging facility off causes the counters to be reset to zero. 


Messages: 


ASGN-ERR 


indicates that an optional fd could not be assigned; e.g., fd 
is assigned for exclusive use already. C7 8 


ERRC-ERR 


indicates that error recording was not specified at sysgen 
time. : . : 


FD-ERR 
indicates an invalid fd. 
FORM-ERR | | 
speadeares a command syntax error. 
1O-ERR | | 


indicates that an I/O error was encountered on output file or 
device. , 


PARM~ERR 


indicates an operand syntax error. 


{ FILES 
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3-17 DISPLAY FILES COMMAND 


The DISPLAY FILES command permits information from the directo 


of one or 


direct access files to be output to the syst 


console or, optionally, to a named file or device. 


Formats: 


Parameters: 


voln: 


filenane 


ext 


actno 


fd 


— volns: | filename)]. ext 
DISPLAY FILES Ht, ve so ° 


i 


is a 1- to 4-character name of a disk volum 
The first character must be alphabetic, t 
remaining alphanumeric. If voln is omitte 
the default system volume is assumed. 


is a i- to 8-character name of a file. T 
first character must be alphabetic, t 
remaining alphanumeric. 


is a 1i- to 3-character extension to t 
filename. 


is a decimal number from 0 through 2 
specifying the account number associated wi 
the file. The account number field may 

omitted, in which case system files (accou 


0) are displayed. : 


is an optional file descriptor specifying t 
file (account number must be 0 if specifie 
or the device to which the lisplay is outpu 
If fd is omitted, the display is output to t 
system console. . 
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‘Functional Details: 


A hyphen (-) in the command format requests that all files 
Starting with the characters preceding the - be displayed, 
subject to any restrictions specified in the extension, account 
number, and fd fields. 


Examples: 
CAL32-—  - displays all files whose first five 
7 a characters are CAL32. 
CAL32.- Wee _ displays all files named CAL32 with 


any extension. 


The character * requests that all files with matching characters 
in the same position(s) as those entered are displayed. 


. Brampless: 

CAL32*** displays all files between five and 
- @ight characters in length whose 

first five characters are CAL32. 
CAL**CAL displays ali. files whose first three 

- and last three characters are CAL. 
**** 32 OBI displays all files with a filename 
. containing six characters whose 
fifth and sixth characters are 32 
and whose extension is .OBJ. 

The characters * and - can be combined in the zommand format, as 


previously described, to further delimit displayed files. 
Example: 


CAL**1- displays all files whose first three 
characters are CAL, and whose sixth 
‘character is 1. 
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An example of the display produced by the DISPLAY 


is: 


D F,FIX¥D:~.TSK/0O 


VOLUME=FIXD 


LENGTH 


FILES 


command 


=> Se cee cee ee ae ae CED ene GR EP ome ame eo 
. 


unique 


.- FILENAME EXT. TYPE KEYS START/NLR CREATED WRITTEN ACT 
DSKSPACE TSK CO 9. F400 E* 6/09/79 6/09/79 0 
OSCOPY ' TSK IN 256 **00 21 6/09/79 6/99/79 ) 
JFC TSK CoO 81 **00 E3* 4/07/79 4/97/79 0 
COBOL TSK co 26 **00 134* 7/27/78 0/00/00 0 
DISKCDUMP TSK co 4O **00 T4E* 7/27/78 7/27/78. O 
COPY 32 TSK CO 145 **00 176* 4/18/79 4/18/79 0 
CAL0O501 TSK IN 256 **00 98 7/24/79 7/24/79 0 
CALMACRO TSK IN 256 **00 93 7/24/79 7/24/79 0 
MTM TSK CoO 215 **00 31B* 7/39/79 7/30/79 O 
EDIT32 TSK co 145 **Q0 62C* 7/28/78 7/28/78 0 
LIBLDR TSK IN 256 **00 37 4/18/79 4/18/79 0 
MACROUTY TSK IN 256 **00 113. 7/28/78 7/28/78 0 
BAS 32D TSK IN 256 **00 85 7/28/78 0/00/00 0 

TSK CO 3 **00 7C8* 7/30/79 0 


MIMASST 7/30/79 


For contiguous files, IYPE is CO, LENCTH is the number of sectors 
allocated to the file in decimal, and START/NLR is the starting 
sector number in hexadecimal, followed by *. 


For index files, TYPE is IN, length is the logical record length 
in decimal, and the START/NLR is the number of logical records in 
decimal. ; . 7 


For all files, ACT is the associated user account number. For 
OS/32 systems containing MIM, the account number denotes’ the 
user to whom the file belongs. For systems without MIM, 
all files are system files with account number 0. #£=A double 
asterisk (**) in the KEYS field indicates a system or group file 
in which access, read, write, or both, is restricted. Refer to 


the OS/32 Multi-Terminal Monitor (MTN) Reference Manual for 
further information. 
Examples: 

DF displays to the console davice all 
files with account number 0 on the 
default system volume. 

D F,CAL32.TSK/- displays file CAL32.TSK in any 

- accounte 

D F,-/- displays all files on the iisk. 

DE,,MAG1: displays to the device H4AG1 all 
files with account number O on the 
default system volume. 
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D F,M300¢ | displays to the console device all 
files with account number OQ on 
volume M300. 


D F,M300:A-.TSK displays all files on volume M390 

| with first character A and extension 
TSK in account number 0. 

D Fy,~e,PR1: | displays all files on the default 
system volume in account number 0 
with blank extension, regardless of 
filename. The display is routed ta 
device PR. | 3 

D F,CAL**1-.- displays, to the console device, ail 

files that start with CAL, contain 
the character 1 in the sixth 


position, have any extension, and 
are in account number 0.) 


Messages: 


REGNS ERY 


Pnareneas that an optional fa could not be seeianeds GsJe,y £4 
is assigned aor exclusive use already. 


FD-ERR 
indicates an invalid optional fd. 
FILE NOT FOUND 
indicates that the specified file was not Found. 
FORM-ERR | 
indicates a command syntax error. 
I/O-ERR | | | 


indicates that an I/O error was encountered on output device 
or file. 


NODA-ERR 


indicates that direct access support is not included in this 
system. : 


NO DIRECTORY ENTRIES ON voln 


indicates that voiln has no files on it. 
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3.18 DISPLAY FLOAT COMMAND 


The DISPLAY FLOAT command displays to the specifiei fd tt 
contents of the single precision floating point registe: 
. associated with a user-specified task. 


Format: 


DISPLAY FLOAT H 


Parameters: 


fd is an optional file descriptor specifying t 
file (account number must be 0 if specifie 
or device to which the display is output. 
fd is omitted, the display is output to t 


system console. 
| 


Functional Details: 


The user-specified task must be established with the. FLOAT aptt 
specified at Link time. 


Examples 


PSW 000077F0 OO00E588 
0,2 00000000 00000000 
4,6 00000000 00000000 
8,A 00000000 00000000 
C,E 00000000 00000000 


Messages; 
ASGN-ERR 


indicates that an optional fd could not be assigned; e.g.,' 
already is assigned for excluSive uSe.. 
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FD-ERR 

indicates an invalid fd. 
-FORM-ERR 

indicates a command syntax error. 
I0-ERR 


indicates that an I/O error was encounterei on output file or 
device. 


NOFP-ERR 


indicates that specified task was not established with the 
FLOAT option at Link time. 


PARM-~ERR 
indicates an operand syntax errore. 
TASK-ERR 


indicates that no task was specified or user-specified task | 
does not exist. 


an nan MAR nan ; ; 2— 204 
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19 DISPLAY ITAMTERM COMMAND 


he DISPLAY ITAMTERM command permits information relative to. 


llocated data communications LCBs to be output to the system 
onsole or, optionally, to a named file or device. 


Ormat: 
; filenane ext 
DISPLAY JTAMTERM ,voln: e Lag 
| fd : 
a2 Le 
arameters: 


voln: is the data communications devices to he 
searched. 


filename is a 1- to 8-character name. The first 
character must be alphabetic, the remaining 
alphanumeric. 
ext is a t- to 3-character extension. 
fd is the file descriptor of the file (account 
number must be 0 if specified) or device on 
which the display is to be output. If fd is 
omitted, the display is output to the systen 
console. e 
he information displayed is: 
Device name, filename, and extension 
Device code (decimal) 
Data communications extended device code (hexadecimal) 
Transmission block size (decimal) 


Logical record size (decimal) 


Number of transmission blocks (decimal) 
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( 


, 


Examples: 


D I,BSCI: displays all data communications 
terminal LCBs with device mnemonic 

BSCI:. 
DI,BSCI:-.- displays all data communications 


terminal LCBs . with device mnemonic 
BSCI: and any extension. 


D I,BSCI:-.LIN displays all data communications 
terminal LCBs with device mnemonic 
BSCI: and extension LIN. 
D I,BSCI:AJM.LIN . displays all data communications 
terminal LCBs with device mnemonic 
BSCI, filename AJM, and extension 
D I,BSCI:,MAG1: | displays on device MAG1:, all data 
. communications terminal LCBs with 
device mnemonic BSCI:. 
Messages: 
ASGN-ERR 


indicates that an optional fd could not be assigned; eege, fd 
is assigned for exclusive use already. 


FD-ERR 
indicates an invalid optional fd. 
FORM-ERR | 
indicates a command syntax error. 
ITO-ERR 
indicates that an I/O error was suesdn ete on output device. 
NOPR-ERR 
indicates that a required operand is missing. 
PARM~ERR 


indicates an operand syntax error or data conmunications 
devices not supported in the systen. 


SPECIFIED TERMINAL(S) NON-EXISTENT FOR voln 


indicates that a specific data communications terminal is not 
found or voln has no LCBs allocated for it. 
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| DISPLAY Lu | 
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3.20 DISPLAY LU COMMAND 


The DISPLAY LU command permits the operator to display 
assigned logical units of the currently selectad task. 


Formats: 


DISPLAY LU Hy 
= | Se 


Parameter: 


fd - is an optional file descriptor specifying 
file {account number must be 0 if specif 
or. device on which the assigned logical u 
are to be displayed. If fd is omitted, 
display is output to the system console. 


Functional Details: 


The lu number, file or device name, current access privile: 
current record number, and percentage thru file are display; 
The current record number and percentage thru File are displ: 
only for files. _ 


LU. FILE/DEVICE RECORD THRU 
1 M67A:RADPROC.CSS/000,SRO 30 15.0% 
3 CON:,SRW . | : 

5 CON:,SRW 

6 CON:,SRW 

4 M67A: RADPROC.CSS/000,SRO 200 100.0% 

3 CON:,SRW | 

4 M67A:&2614586.001/000,SREW 1 100.0% 

5 CON:,SRH . 

6 CON:,SRW 

Example: 

DISP LU,PR: displays assigned logical units 


the printer device (PR:). 
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Messages: 


ASGN-ERR 


indicates that optional fd could not be assigned; eeg-, fd is 


assigned for exclusive use already. 
FD-ERR 

indicates an invalid optional fd. 
FORM~ERR 

indicates a command syntax error. 
IO-ERR 


indicates that an I/O error was detected on output device 


PARM-ERR 
dndicates.an operand syntax error. 
TASK-ERR 


indicates that there is no currently selected task. 
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Or 


i MAP | 


3-21 DISPLAY MAP COMMAND 


The DISPLAY HAP command causes a memory map to be output to t 
console or to a specified file or device. The display map may 
of the entire system or of a particular task, pure, library, 
task common segment, system space, pseudo task, or marked oa 
memory. 


Format: 


DISPLAY MAP |/ 


Parameters: 


id can be either .BG to refer to the backgroun 
task or the name associated with a taske 


-TSK | requests display of task segmentse 

» PUR | requests display of pure segments. 

SEG requests display of library ana task commo} 
segmentse 

eSYS requests display of system space. 

~OFF He quests: display of all OFF nemory segments. 

- PST requests display of pseudo tasks created by a 


system task using the intercept feature. 
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rname | requests display of a specific library 
segment, task common segment, sharabla pure 
segment, or a taskid. 


fd | is the file descriptor specifying the file 
(account number must be 0O if specified) or 
davice on which the map is to b2 output; if fd 
is omitted, the display is output to the 
systen consoles. 


“Functional Details: 


If segment type and rcname are omitted, all tasks, task common, 
library and pure segments, marked off memory, pseudo tasks, ani 
System space are displayed. The name, segment type, start 
address, segment size, size of system space, number of shared 
segments, status, and priority are displayed. If rename is 
specified, only the above information for that task or segment is 
displayed. For id, all sharable segments are also iisplayed. 
The first Line of the display indicates the starting address and 
size of the total task memory space. 


Examples: 


This example shows the display for two system tasks, two 


foreground tasks, a background task, and two task common 
segments: . 
DM 
NAME . TYPE START SIZE SEG SYS STAT PRI 
TASK MEMORY . 1D000 321.00 
SPL -ITSK 1D000 11.25 . A 128 
oKTM «TSK TFDOO £33.00. RES A 128 
USER? eITSK 28100 4.00 2229. OD 129 
US ER2 -TSK 29100 25.75 4.95 D 129* 
eBG . eISK 2F800 4.90 1.25 D 128 
TSKCOM1 © . ~-SEG 30800 2 «50 
TSKCOM2 eSEG 31200 10 ..00 . | 
SYSTEM SPACE 7 6D400 75-00 8.34 
a 


The following example shows the display for one ‘sharable pure 
segment, four library segments, one task common segment, one off 
memory segment, and five foreground task segments. 
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NAME TYPE START SIZE SEG SYS STAT PRI 


TASK MEMORY 2 22000 1044.00 

MO7AEDIT32— TSK «PUR 24800 28.00 1 

PLUSRTL «SEG 2B800 2-00 2 

NMINUSRTL «SEG 2C000 2-00 2 

MULRTL «SEG 2C800 2-00 2 

DIVIDRTL - «SEG 2D000 2209 2. 

ICOM 2SEG 2E000 2-00 2 

OFF MEMORY C0000 256.00 OCF 

EDIT32 [SK 22090 10.00 14 2.2°* P 128 

TEST 1 eISK 20800 2.06 Bb 4.25 — D 128 

TCOMTEST eTSK 2F39G9 24.00 1 1-00- D 128 

ee Sak eidk 34800 2200 4 1225 D 128 
LOOP efTSK 35000 4.00 1 1.200 A 130. 
SYSTEM SPACE 127000 100.00 12.75 


The NAME field is the name of a task or segment, and .BS 
indicates the background segment. Any other name indicates a 
foreground task, global task common segment, or library segment. 


For pure segments, NAME is the fd of the file containing the pure 


segmente 


_ The TYPE field describes the segment type. Possible values are: 


TSK -Task memory image form (impure) 
- PUR Task emo image: foum <paces 

- @~SEG Task common or library 
ePST pasuden task 


The START field is the absolute starting address of the segment 
in memory. The system space line contains the starting address 
of the system space ani represents the upper limit of the task 
Space plus 1. The task memory line contains the starting address 
of the task space and represents the upper limit of the “werating 
system space plus 1. 


The SIZE field indicates the size in kb of the segment. The 
sizes are a multiple of 0.25. The task memory and system space 
lines contain the maximum available task and system space. 


The SEG field contains the number of shared segments for a task. 
For a shared seuyument, the SEG field indicates the number of tasks 
currently shariag cre Soguone: 


The ©¥2 fietdl wnatcates the amount of systean spate a ask ai: 
using. Fy2 Svsta7 space line contains the toratil anount a syste 
Spac.c wurtcently ia suse. 
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The STAT field indicates the status of these tasks, as follows: 


D | Dormant 
P | - Paused (console wait) 
A. oe Active (any state other than dormant or 


paused) 


The status can be preceded by RES indicating the task is memory 
resident, ROL indicating the task is rollable, or ROLLED 
indicating the task is rolled. A task displayed on tha map as 
active may in fact be in a wait state. The system operator can 
use the TASK and DISPLAY PARAMETERS cammands to get the actual 
Wait status halfword for a given task. The PRI field indicates 
the priority in decimal of all tasks currently in the system. An 
asterisk (*) next to a value in the priority field indicates that 
the actual run priority of that task has been lowered by MIM. 
OFF identifies marked off memory. 


. Hessages: 


ASGN-ERR 


indicates that the output device or file couli not be 
assigned; e.g-, device returns unrecoverable error on I/0> 


attempt. 
FD-ERR 
indicates that an invalid fd gas epee ee icas 
FORM-ERR | | | 


indicates a command syntax error. 


IO-ERR 
indicates that an 1/0 error occurred | on output device or 
file;  e.g-, device returns unrecoverable error on I/0 
attempt. ve ge 
PARH-ERR 


indicates an operand syntax error.e 
SEGMENT REQUEST NOT FOUND 


indicates that the requested segment was not found, or no 
tasks exist in memory. 
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3.22 DISPLAY PARAMETERS CONMAND 
The DISPLAY PARAMETERS command is used to display paramet 
pertinent to the currently selected task. The display appears 


_ the console device, or on a device or file (account number mn 
be 0 if specified) selected by the operator. 


Formats 


DISPLAY PARAMETERS H. 


Parameter: 


fd is an optional file descriptor specifying 1 
. file (account number must be 0 if specific 
or device to which the display is to 
output. If fd is omitted, the display appea 
on the system console. a | | 


Functional Details: 


Table 3-3 lists the field addresses and data displayed when t 
DISPLAY PARAMETERS command is entered. 


TABLE 3-3 FIELDS DISPLAYED BY THE DISPLAY 
PARAMETERS COMMAND 


mo ae ee on OE ees ore Gee em Can Ome am OS Gee a eR eR ae em Om ee ee a eee ee en Oe ee ee OR SD ee OL ee ee aoe emp Ee ee ee SED See Oe ee ee ee em 


] TASK | TASKID | TASK NAME | 
j ee | 
{ CTSW | xxxxxxxx | Status portion of current | 
| | | task status word (TSW) | 
{ I | I 
{ PSW | xxxxxx | Least significant three bytes | 
| | J of status portion | 
| I | ! 
{ CLOC | xxxxxx | Current location | 
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TABLE 3-3 FIELDS DISPLAYED BY THE DISPLAY 
-PARAMETERS COMMAND (Continued) 


Eee Seep ce ent CeNY wine eee et de Ge Gime SUD OD eee OR Ob ce SE a wee com Gre ome ene) feb eee tee eth cm ome wey mee em ert oom wah enh Sun ene afin Gh am Gm wee ond ome eh oo 


| TASK | TASKID | TASK NAME 1 
Stn Gees (tseh wale gegen | 
| TOPT XXXXX Task options : 
| USSP | XXXXX Current used system space - 
: MUSP | XXXXX | Maximum used system space 
MXSP ! xXXXX ! Maximum allowed system spate ! . 
crop XXXXX | Task crop | 
! UTOP XXXXX Task UTOP 
| ee XXXXX | Task UBOT 
SLOC XXX :. Task Biserag location : | 
! NLU : XX : Number of logical units — | 
j | } (decimal) © | { 
Ly | | | | l 
| MPRI | xxx | Maximum priority (decimal) 1 
SVOL | xXXX Default volume id 
TVOL | XXXX euevost task eres” 


am ee et me le eee re ah ant oe cee Oe me Oe EP Ee Ee Se SE oP Ome Se gee ee ee eet ee ee om aw an ee mh my ee ow ene we ee ow enh mee een es ee OP on am 


The addresses displayed as CTOP, UTOP, UBOT, and SLOIC are not. 
physical addresses, but are addresses within the task"s own 
program space. CLOC may be a program space adiress or a physical 
address in a system subroutine being executed on behalf of the 
task. NLU is given in decimal. SVOL is the ASCII system. volume 
id. It is not specifically related to the currently selected 
task, but is given here for operator convenience. TVOL is the 
ASCII task volume name associated with the currently selected 
task. CISW is given in hexadecimal. For a definition of the 
status portion of the TSW, and a description of the fields CTOP, 
UTOP, UBOT, and SLOC, see the OS/32 Application Level Programmer 
Reference Manual. 


TOPT is given in hexadecimal. The definitions of task option 
bits are listed in Table 3-4. 
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TABLE 3-4 TASK OPTION BIT DEFINITIONS 


: am ews een OE eS ee ew we Oe Om ow Oe Ow ee ee ee ot Oe ow WF om me Ow a ae we BO OF ow aw EO) ee on Oe Ow oe Oe ee EE ge OF 2 OP 8 ee ee oe ee ee em em aoe me ome 


~] 


wo 


nb 
Oo 


11 


12 


13 


14 


15 


16 


17 


18 


MASK 


0400 0000 


0200 0000 


07100 0000 


0080 0000 


0040 0000. 


0020 0000 
0010 0000 
0008 0000 


0004 0000 


0002 0000 
0001 0000 
0000 8000 
0000 4000 


0000 20600 


MEANING 

Reserved 

0 - Prompts disabled 

1 - Prompts enabled 

0 - I/0 interpreted without vertical 
forms control (except where speci- 
fied) 7 

4 - All I/O interpreted with vertical 
forms control . 

0 - No extended SVC 1 parameter blocks. 
used (excludes communications I/0) 

1 - Extended SVC 1 parameter blocks 
used 

0 - New TSW for task event service 

1 -~- No new TSW for task event 

0 - Task event all registers savel 

1 - Task event partial register saved _ 

0 - Task event no register saved. 

1 - Task event register saved 

0 - Not in system group 

1 ~-- In systen group 

0 - No console I/0 intercept 

1 - Console I/O intercept enable (MTM) 

0 - Universal status reports not 
allowed . 

1 - Universal status reports allowed 

0 - Allow e-task load 

1 - Prevent e-task load 

0 - Queuved I/Os not purged on 

1 - Queued I/Os purged on error. 

0 =. Gtk 

1 - E-task 

0 - AFPAUSE 

1 - AFCONT 

QO - NOFLOAT 


Single floating point 


ee eee ee ey Se Sem ey EE NE GER OE SE ees EES SR SY eee OEY SURED SO Gay Sm i ee Gee ee ee Se es ee SEE ee cree nD WN Sree mes oe EP ome Se Se See eee amen enwe VERE ERAN One ee weer out meee ene 
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service 


error 
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TABLE 3-8 TASK OPTION BIT DEFRNITIONS (Continued) 


Ret ee a ER Ge Ow Ome Cee Ome we ahh) Gu BRE CEh Gee ee Ge ails Gu One 08 Sus eee ee GOT ee ee om ae dep Ow ele GR Oe en OE ORD wah ae OND OD OOS obm GRP Gnd Eee ORR die A On OO ee oe om on aw 


C cavcthrved Ahan Dhaian Eiensed aaaelentoceline-Ub-eneAivanreth egtliacadh-conthranetertenteeaanth cas Aree tb arentenaatcsedeate Aran dtemadtt aandenedanendirandhesetpacedi randhnedt cade -theaednee tone ibrserEinacedher-Aiaee- Anan Epeperth-aarctivene Aramtleeas Trenredl ar thaereah remapped wnat indies Tammtpcnie) 
ee eed 


0000 1000 | 0 - NONRESIDENT | 
- 1 - RESIDENT 


1 - Do keychecks (e-tasks only) 


{ { 
| l 
! I | | 
| l | | 
{ | { | 
} 20 {1 0000 0800 | 0 - SVC 6 control call | 
|. | | 1 - Prevent SVC 6 control call { 
| { Le sat | | 
} 21 | 0000 0400 | O - SVC 6 communication call | 
| | - | 1 ~- Prevent SVC 6 communication call { 
i | | | | 
| 22 | 00900 0200 | 0 - SVCPAUSE | 
| | . . | 1 - SVCCONT ae or 
| !. oe | 7 [ 
| 23 | 0000 0100 [ 0 — NOFLOAT i 
| | | 1 - DFLOAT | 
l l | I 
{ 24 | 0000 0080 | O - NOROLL . | 
{ 4 | 1 - ROLL 
i | . | | 
f 25 | 00090 0040 { 0 -— No overlay | 
| | } 1 -~- Use overlay f 
a | 7 | 
| 26 | 0000 0020 | O ~- Accounting disabled | 
| i: { 1 ~- Accounting enabled | 
| | of a as | | 
| 27 {| 0000 0010 | O - Task can issue interzept calls { 
| | | f 1- Task cannot issue intercept calls | 
{ | | | | | 
{| 28 | 0000 0008 | 0 - No account privileges | 
{ | — | 4 - File account privileges | 
| ee | | 
|} 29 |} 0000 0004 | O - Bare disk assign not allowed | 
| | | 1- Bare disk assign allowed | 
| | l a | I 
—$ 30 | 0000 0002 | 9 - Not universal | 
| | - | 1 - Universal i 
{ | re | 
{ 37 | 0000 0001 { 0 - No keychecks | 
| i | | 
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STAT is given in hexadecimal. The definitions of wait status 
bits are shown in Table 3-5. 
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TABLE 3~5 WAIT STATUS BIT DEFINITIONS 


— ee ee Se ee Oe ne eee ae oes ee oe 8m Oe 8 OF a © ee Oe oO SF oe em of me cw ow ce em FF BW oe ED oe EP om SO we Ew Oe ot me Gm are em eee BES ee are re On ee ee oe oe ee 


BIT | MASK | MEANING | | 
"45 | 0001 0000 | Intercept wait | | 
16 0000 8000 I/O wait 
17 | 0000 4000 | (Any) LOB/WAIT 
18 0000 2000 Console wait (paused) 
19 0000 1000 | Load wait 
20 0000 0890 ; Dormant ee : 
21 G000 0400 | Trap wait 
22 0000 0200 Time of day wait : 
23 0000 0100 Suspended | | 
24 0000 0080 Tiesevad weet 
25 0066 0040 Terminal wait ; 
26 0000 none Roll pending wait | 
27 0000 0010 |! Intercept initialization (MTH) - + 
28 0000 0008 Intercept termination (HTM) | 7 
29 0000 0004 System resource connection wait ! 
30 i 0000 sue | Accounting wait 


on ee ee Ee et ee ee OUP one OEP ae Ow ane a a an Oe om WEP Om Ee Oe GED OF ae om ow GR OS Om OR am SE GE OE oe OFF Om OED OE8 om N 8 Ee OF OD ew Om om ew a ae 


NOTE 


Zero status indicates the task is active. 
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Example: 


The following is an example of che: output generated in Yxresponse 
to a DISPLAY PARAMETERS command: 


D-P 


TASK ~EDIT32 
CTSW 00001000 
PSW 4u77EO 
CLoc F2B7C 
STAT 2000 
TOPT 10021 
USSP 14F8 
MUSP 2208 
MXSP 3000 
CTOP 2UFE 
UTOP 2370 
UBOT oO. 
SLOC ~ FOO0O 
NLU wast 4485 
MPRI..-.-. .—s 428 
SVOL M67A 
TVOL  MG6O7A 

Messages: 

ASGN-ERR 


indicates that an optional fd could not be assigned; e.ge, fd 
already is assigned for exclusive use.. 


FD-ERR 

indicates an invalid fd. 
FORM-ERR | 

indicates a command syntax Errore | 
ITO-ERR | | 


indicates that an I/0 error was detected on output ievice or 
file. 


PARM-ERR 
indicates an operand syntax error. 
TASK-ERR 


indicates that there is no currently selected task. 
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3.23 DISPLAY REGISTERS COMMAND 


The DISPLAY REGISTERS command displays to the specifiel f1 the 
contents of the general purpose user registers associated with a 
user- specified taske 


. Formats 


DISPLAY REGISTERS [,fd] 


Paraneters: 
fd is the file descriptor to which the contents 
of the aad purpose user registers are 
displayed. . . 
Examples 
DR ; 
PSW O0O0Q0077F0 OOO00E588 ™ 
0-3 00000000 00000000 00000000 00004801 
4-7 OOO0O0E83C 00000000 00000000 OOOOD2EA 
8-8B OOOOESCB 00000000 OOO0ES 48 00000028 
C-F OOOOES8OY4 OO0OO00E9DO OOO0DE584 QOOO0O0EOS5SE 
Messages: 
ASGN-ERR 


indicates that an optional fd eaata not be assigned; CeGe, fd 
already is asSigned for exclusive use. 


FD-ERR 
indicates an invalid fd. 
FORM-ERR 


indicates a command syntax error. 
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IO-ERR 


indjicates that an I/0 error 
file. 


PAR A-ERR 
indicates adn operand syntax 


TASK-ERR 


was detected on output device or 


error. 


indicates that no task was specified or user-specified task 


does not exist. 
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3.24 DISPLAY TIME COMMAND 


The DISPLAY TIME command causes the current date and time to. be 
output to the system console or to a specified file or ievice. 


Format: 


? fd 
DISPLAY TIME 5B 4 
(sys console 


- Parameters: 


fd specifies the file (account number must be 0 
if specified) or device to which the display 


_ is to be output. If fd 


onmnitted, the 


display is output to the system console. 


Functional Details: 

The display has the following format: 
mm/dd/yy hhenn:ss 

Or alternatively by sysgen option: 
dd/mm/yy hh:nn:ss 

Messages: 


RSGN-ERR 


indicates that an optional‘ fd could not be assigned; eeg., fd 


already is assigned for exclusive use. 
FD-ERR 


indicates anm invalid fd. 
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FORM-ERR 
indicates a command syntax error. 
TO-ERR 


indicates that an I/O error was encounterei on output device 
or file. 


’ PARM-ERR 


indicates an operand syntax error. 
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{| DISPLAY {| 
| VOLUME | 
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3.25 


DISPLAY VOLUME COMMAND 


The DISPLAY VOLUME command displays to the specified fd the state 
of the specified disk volume. This command is papbertes only on 


disk 


devices which support error recording. 


Format: 


pxsPLaY vouMe yvo1a [1 


Para 


Exam 


meters: 

voln is the volume name of the disk whose status is 
displayed. 

fd | is an optional file descriptor specifying the 
file (account number must be 0 if specified) 
or device to which the specified disk volume’s 
status is displayed. Tf fd is omitted, the 
display is output to the systen console. . 

ples: 

D V,FIXD 


VOLUME= FIXD 
FREESPACE = 18676 SECTORS 6 EXTENTS 95.36% OF TOTAL 


Volume FIXD has no error counting capabilities. 


D V,MT51 

VOLUME= M300 

FREESPACE = 222498 SECTORS 23959 EXTENTS 22-234 OF TOTAL 
REQUESTS = K74H61 READ © -21552 WRITTEN 69013 TOTAL 
SECTORS = 588784 READ 112624 WRITTEN 791408 TOTAL 
AVERAGE LATENCY: 0.377 SEEK/REQ 33 ROTATION (SECTORS/REQ) 
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‘Fields: 


FREESPACE= | is the amount of freespace on 


the 


specified 
volume displayed as number of sectors, number 


of extents, and percentage of total space. 


SECTORS= - is the number of free sectors on the specified 
. volume. — ; sae 
EXTENTS= is the number of contiguous free blocks of 


sectors on the specified volume. 


REQUESTS= is the number of read, write, and 


total 


requests made to the specified volume. 


SECTORS= ‘ dis the number of sectors reai from, 


AVERAGE in the SEEK/REQ field, the average latency is 
done 
request. In the ROTATION field, 
latency is the average wait 


LATENCY= the average number of seeks 


for 


rotation/request measured in sectors. 
| 64 sectors. 
Therefore, half a rotation equals 32 sectors. 


disks, one rotation equals 


‘Volume M300 has error counting capabilities. 
Messages: 


ASGN-ERR 


indicates the optional fd or disk device of 
voln, could not be assigned. 


DEVICE NOT A DISK 


indicates that the specified device with volume 
is not a bulk device. ; 


FD-ERR 

indicates an invalid optional £4. 
FORN-ERR | 

indicates a command syntax error. 


I/O-ERR 


indicates that an I/O error was encounterei on disk device of 


volume name, voln, or on output device.- 


~s 


48-030 FOQO ROO 


volume 


hame, 


per 


S¥C1 


2 3 written 
to, and total number of sectors accessed. 


I70 
the average 
disk 
For MSM 


name, 


voln, 


NODA-ERR 


indicates that direct access support is not included in this 
system. 


NOPR~ERR 
indicates a required operand missing. 
PARM-ERR 


indicates an operand syntax error. 
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3.26 ERROR LOG COMMAND 


The ERROR LOG command turns on or off the error recording 
function, which copies the errors from the error logger to tha 
disk. This command controls general errdr recording for all 
_ processors and memory error recording for the Perkin-Elmer 3200 
Series processors. 


Format: 


on [- [ed] [-rnr7] | 


ERROR LOG , 


OFF 
Parameters: 

OFF = dumps the internal error record buffer to disc . 
and closes the error recording files. 
Internally, errors are still storei, but not 
written to disk, which causes data to be lost 
in the internal buffer overflow. 

ON turns on the error recording function. 

fa specifies the contiguous file to be used for 
error recordings If this parameter is 
omitted, the file specified at sysgen is the 
default. If the user-specified fd does not 
currently exist, the file is automaticaily 
allocated and assigned. an 

INIT initializes the error recoriing file so that 
new error records can be added to the 
beginning of the file. If this parameter is 
omitted, subsequent error records are added 
following the last records written to the 
file. 

Messages: 


CLOS-ERR TYPE=BUFF 


indicates an error occurred when closing the error recording 
file. TYPE=BUFF means system space has. become corrupted and 
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buffers and/or file control blocks cannot be returned to the 
free system space. 


DATE-ERR 
indicates that the ON parameter was specified but the date 
and time parameters of the SET TIHE command were not 
specified. - 

NOPR-ERR 
indicates that no parameters were specified. 


OFF-ERR 


indicates that the OFF parameter was specified but the. error 
Beene sng function was already off. 


ON-ERR- 


indicates that the ERROR LOG command was entered _ twice with 
“ie ON parameter specified. © 


PARM-ERR 


indicates that a syntax error exists in the specified 
parameter. 


PRES-ERR 


indicates that error recording is not supported. 
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3.27 ERROR PERIOD COMMAND 


The ERROR PERIOD command sets the memory error log readout period 
to a user-specified number of minutes. The .default value is 
specified at sysgen. This command can be used only with 
Perkin-Elmer 3200 Series proce ssorse 


Format: 
minutes 
ERROR PERIOD |, 
: * 
Parameters: 
minutes | is a decimal number from 1 through 1440 
' specifying the number of minutes between error 
log readouts- If this parameter is omitted, 
the time period is reset to the initial sysgen 
value. 

x | specifies that the memory error logger 
performs a readout immediately. The 
previously set readout period is not affected. 

Messages: . 


INIT-ERR 


indicates that memory error recording was initialized but it 
already had been specified and was in progress. 


NOPR-ERR 
indicates that no parameters were specified. 
PARM-~ERR 


indicates that a syntax error exists in the specified 
parameter. 
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PER D-ERR 


indicates that the nuaber of minutes specified for the error 
log readout period was not a number fron 1 through 1440.. 


SPAC-ERR 


indicates that there was not enough systea space allocated 
for an error log buffer. 
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3.28 ERROR RECORDING COMMAND 


The ERROR RECORDING command turns error recording on or off for 
a specified device. . 


Formats: 


| | ON 
ERROR RECORDING ,f4, 
: ) A QEF 
Parameters: 
fd | - ds the device name for which errors are being 
3 recorded. , : 
ON: specifies error recording is enabled for. the 
‘ specified device. 
OFF - specifies error recording is disablei for the 


specified device. ; 


Functional Details: 


The number of errors recorded for the specified device is reset 
to zero at system initialization. 


Messages: 


ERRC-ERR 


indicates that error recording for device is not supported in 
system. 


NOPR~-ERR 
indicates that no Parameters were specified. 
NSUP-ERR - 
indicates the device does not SunpeEe error recording. 


PARNH-ERR 


indicates that a syntax error exists in the specified 
parameter. = 
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3.29 EXAMINE COMMAND 
The EXAMINE command is used to examine the contents of local 
shared memory. 


' Format: 


mn 


EXAMINE address,| </address, B 


Parameters: | 
address indicates the starting and ending adiresses 
memory whose contents are to be displayed 
hexadecimal. All addresses specified 
rounded down to halfword boundaries by 
system. . ‘ 
n | is a decimal number specifying the number 


-halfwords to be displayed. If n is onitt 
one halfword is displayed. 


fd . is the file descriptor specifying the f£ 
(account number must be 0O if specified) 
device to which the contents of memory 
displayed; if omitted, the display is out 
to the system console. 


Functional Details: 


Specifying only address; causes the contents of memory at {1 
location to be displayed (as modified by any previous ] 
command.) Specifying address, and address causes all data j 
the first to the second address to be displayed. — 


Example: 
BI BOOO examines 10 halfwords startin 
EXA 100,10 relative address 100 (abso 


address Bt00O). 
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Nessagess: 


ASGN-ERR 


indicates that an optional fd could not be assigned; e.g., fd 


already is assigned for exclusive use. 
FD-ERR | | 

| indicates an invalid fd. 

- FORM-ERR | 

indicates aveounand: ern tas eLCrore 


IO~ERR 


indicates that an I/O error was detected on output device 


file. 
NOPR-ERR > 
indicates that a required operand is missing. 


PARM-ERR 


Or 


indicates an operand syntax error (an attempt t9 examine 
memory reserved for memory access controller (MAC) or narked 


off and possibly Mone AES tents 
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3.30 FFILE COMMAND 


The FFILE command forward spaces to the next filemark on magnet 
tapes, cassettes, and direct access files. 


' Formats: 
FFILE fd oo Used for magnetic tapes a 
cassettes only 
FFILE fd [,lu] = Used for disk devices only 


Paraneters: 
fd is the file descriptor of the device or fil 
to be forward spaced one filemark. 
‘lu | is the logical unit to which the file 
assigned. 


Functional Details: 


For magnetic tapes and cassettes, only the parameter fd should 
specified; for direct access files, lu optionally can 
specified. The account number must be 0 if specified. 


Before entering the format for disk devices, the task must 
selected as the current task through ‘the TASK command. 


Exampless 
FF MAG2: causes the device HAG2: to forwa 
space one filemark. 
FF M300:AJM.OBJ,4 causes the file AJM.OBJ on volu 


M300 that is assigned to lu 4, 
forward space one filemark. 
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Messages: 


ASGN-ERR 


indicates that the file or device could not be assigneil. for 
the reason noted in the TYPE field. 


FD-ERR 


indicates that an invalid fd was encountered or a nonzero 
account number was specified. 3 


ITO-ERR 


indicates that an I/O error or an illegal or ‘naséigned lu 
was encountered on the specified device - or file. 


LU-ERR 


indicates that the lo was not a Legal deciaal number or was 
greater cna, maxlu Eon the task. 


‘NOBC-ERR 


indicates that bulk file. command support is not included in 
the operating system. 


NOPR-ERR 
indicates that no operand was specified. 
-TASK-ERR 


indicates that there was no currently selected task and an 
FFILE command was entered with lu specified. 
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3. 31 FRECORD COMMAND 


The FRECORD eeiaada forward spaces one record on magnetic tapes 
cassettes, and direct access files. 


' Formats: 

FRECORD fd Used for magnetic tapes ar 
= cassettes only 

FRECORD fad [{,lu] Used for disk devices only 

Parameters: 
fd is the file descriptor of the device or fi] 
to be forward spaced one record. | 
lu . is the logical unit to which the device ¢c 


file is assigned. 


Functional Details: 


For magnetic tapes and cassettes, only the parameter fd should I 
specified; for direct access files, lu can optionally t 
specified. The account number must be 0 if specified. 


Before entering the format for disk devices, the task must Ef 
selected as the current task through the TASK commande 


Exanpless: 
FR MAG2: causes the device MAG2: to forwar 
Svace one record. 
FR M300:AJM.OBJ,4 causes file M300:AJMeOBJ on volun 


M309 that is assigned to lu 4 t 
forward space one record. 
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Messages: 


ASGN-ERR 


indicates that the file or device could not be assigned for 
the reason noted in the TYPE field. 


FD-ERR 


indicates that an invalid fd was encountered or 2 nonzero 
account number was specified. 


-IO-ERR 


‘indicates that an I/O error or an illegal or unassigned lu 
was encountered on the specified device or file. 


_LU-ERR 


Riateates that the lu was not a legal A ociaat number or was 
greater than maxlu. for eae. task. 


_ NOBC- -ERR 


inatoweee that bulk file esnuana support: is not included _in 
the operating system. . 


NOPR- ERR 
indicates that no operand was specified. 
TASK~ERR 


indicates that there was no currently selected task and a 
command requiring the specification of lu was entered. 
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3.32 INIT COMMAND 


The INIT (file initialization) command enables the osperator 
initialize all data ona contiguous file to Q. 


, Format: 


segsize increment 
INIT fa |, a 4 
| eS 
Parameters: 
fd : is the file descriptor of any unassig! 


unprotected, contiguous file. A file wii 
nonzero account number can be initialized 
specifying the account number. 


segsize is the size of the buffer space used. 
increment default is 1tkb. | 


Functional Details: 


INIT is implemented with a CSS procedure that loads and sta 
the File Manager Support Utility as a background (.BG) task. 


Examples: 


INIT DATA.FIL . initializes the file DATA.FIL. 
INIT DATA2.FIL,50 initializes the file DATA2.FIL us 
; a 50kb buffer. 
Messages: 
ASGN-ERR 


indicates an error when an attempt was made to assign 
file to be initialized or the task file for the File Mana 
Support Utility. See the ASSIGN comamani description 
error information. ; 
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FD-ERR 
indicates that an invalid fd was specified. 
fd IS NOT A CONTIGUOUS FILE 


indicates that INIT can be used only to initialize ‘sontiguous 


FORM-ERR 


‘indicates that an invalid segment size increment was 
specified. 7 | 


LOA D-ERR 
indicates an error when an attempt was made to load the File 
Manager Support Utility as a background (.BG) task. See the 


LOAD command for error information on loatjing a background 
task. bf ; : So ; ; 


_MNEM~ERR 


indicates ticat the file INIT. CSS could not Se founi on the. 
Sreben volumee cos 


NODA-ERR 


indicates that there is no direct access support in this 
system. . 


SEQ~-ERR 
indicates that another CSS procedure or background task is 


active. A second INIT command cannot be erecured. until the 
first has completed. 


xxxx ERROR ON fa SECTOR n 
indicates that an I/O error occurred while attempting to 
initialize sector n of file fd. -xxxx is the type of error; 


it may be unrecoverable I/0, recoverable I/0, or device 
unavailable. . 
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3.33 LOAD COMMAND 


The LOAD command loads background tasks, foreground tasks, syst 
tasks, task common segments, and library segments into memory. 


Formats: 


Parameters: 
taskid 


sysid 
“eS 

- TCM 
~ LIB 


eSEG 


tad 


-74 


TCM, 


fd 


fd [,segsize increment] 
taskid [- fed] [,segsize increment] | 
sysid,fd [,segsize increnent] 


-BG,fd [,segsize increment] 


specifies the name of the task after it j 
loaded into the foreground segment in memory. 


specifies the taskid of a system task. Tt 
taskid for the Spooler is .SPL; the taskid fc 
the multi-terminal monitor is .MIM. 


specifies a background task is to be loade 
ints memory with intertask communicatic 
control and capabilities disabled. | : 


specifies that a preinitialized task comme 
segment is to be loaded into memory. It j 
loaded as'a «SEG segment. 


specifies that a library segment is to |} 
loaded into memory. It is loaded as a .SI 
segment.: 


used to load a task common or an RIL segmer 
into memorye Default extension is .5EG. 
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fd is the filename used as the taskid or the fd. 
: of the established task, library, Or 
-.preinitialized task common segment to be 
loaded into memory. If this parameter is 
omitted, the default is taskid.TSK for 
foreground tasks. This parameter is required 
for system tasks, background tasks, task 
common, and library segments. However, if the 
extension of the fd is omitted, the default 
extension is fd.TCM for a task common segment, 
fd.RTL for a library segment, and £4.-TSK for 
foreground and background tasks. _ 


-segsize . § ais ‘a decimal number in kb specifying the 


increment amount of get -storage area in the task‘*s 
. As impure memory segment. If specified, this 


value overrides the OPTION WORK= values used 
when the task was linked. oe | 


| Functional Details: 


A task must be prepared by processing the component programs, 
subroutines, and overlays with Link. Once established, the task 
can be loaded into memory. A task is loaded into the first 
memory segment large enough to accommodate ite A nonzero account 
number can be specified in the fd. | . 


System tasks are extensions of the operating system. Currently 
existing system tasks are the multi-terminal monitor (.MTM) and 
the Spooler (.SPL). fee 


Task common segments within 0OS/32 fall into two classes: 


® those in local memory (below MTOP, as set by the CUP MEMORY 
statement or the MEMORY operator command), and 


® those in global memory (above MTOP). 


Local task common segments are under operator control. The 
commands to add, delete, name, and set the size of local task 
common segments are described below. The number of Ilocal task 
common segments is limited only by the amount of memory 
available. 


Global task common segments are established at sysgen time using 
the configuration utility program (CUP) TCOM command, and are not 
controlled by the operator. The size and segment names are fixed 
at sysgen time. Up to 14 global task common segments can be 
defined in a sysgen. For more information on generating a system 
containing global task common segments, refer to the 05/32 System 
Planning and Configuration Guide. 
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The library segment name specified at Link time is the name by 
which the library is known to the systen. 


When a task is loaded into memory, the impure segment size 
defaults to the size established at Link time, aligned on a page 
boundary. Certain utility and applications tasks require variou: 
get storage area sizes, depending on the particular execution. 
The Common ‘Assembly Language (CAL), for example, requires : 
variable work area in which to build a symbol table. The actual] 
size required is a function of the size and ie of symbols ir 
_. the program being assembled. 


The segsize increment field of the LOAD commani gives the user 
the capability to vary the task's segment size at LOAD time, anc 
to override the amount of memory requested by the OPTION WORK: 
command entered at Link time. If a task is established with = 
minimum amount of get storage area, the memory available can _ be 
changed with the LOAD command. . 


If a task requiring a ICOM or run time library (RTL) is loaded, 
the command processor attempts to load the required segments iJ 
they are not already in memory. In order to accomplish this the 
fd must be identical to the segment name (including the 
extensions). This is done by specifying an fd only in the BUILI 
command of Link and letting segment name default to the fd. The 
command processor searches the user volume/user account, then the 


system volume/system account to locate the shared segment. This 
allows MTM users some flexibility. When loading from the syste: 
console, the shared segment must be on the system volume in the 


system account. 
Examples: 


L ABC, PTRP: , loads a task fron the paper tape 
reader punch device (PTRP?)- 


L .«.BG,VOL: CAL loads a task from file VOL: CAL.IS! 
into the background segment. 


L T1. loads a task from file T1.TSK on the 
default system volume into the 
foreground. Associates the name J’ 
with the task. | | 


Ie 2147 loads a task from the default syster 
volume from file named T1 into the 
foreground. Associates the name T° 

‘with the task. . 


L OSCOPY,X:PSCOPY,1.5 loads a task from file V:PSCOPY.TS! 
into the foreground. Associates the 
name OSCOPY with the task. 
Specifies an expand area of 1.5kb. 


(uJ 
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L .BG,CAL,50.5 | loads a task 
| volume on 
background. 

area of 50.5 


L .fCM,TASKCOM . loais a pre 
or ste. segment from 
L SEG, TASKCOM.TC Memory. 


L .~SPL,SPOOLER loads the Sp 


the default 
- SPOOLER. TSK 
L .LIB,RTL loads a ree 


or . fron file 
L »SEG,;RTL.RTL | a 


Messages: _ 
FD-ERR 
| iuaieates an fa syntax error. 
FORM-ERR | 

indicates a eoauana syntax error. 
LOAD-ERR ITYPE= 

indicates that idad faited ox reason 
NOPR-ERR 

indicates hae an operand is missing. 
PARM-ERK oe : 


indicates an operand syntax errore 
LOAD error TYPE field responses: 


IO 


from the default systen 
file CAL.TSK into the 
Specifies an expand 
kbe . 
initialized task common 


file TASKCOM.TCM into 


oOoler system task from 
_ system volume on file 
into memorye 


ntrant library segmant 


RTL.RTL into memorye 


notei in TYPE field. 


indicates an I/O error on input file. 


LIB 


indicates an invalid format on LIB. 
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MAP 


shared segment table (SST) is full or file not found when 
AUTOLOAD attempts to load a shared segment. 


NAME 
indicates that fd was not found or cannot be assigned. 
NOFP 


indicates that task requires floating point facilities not 
supported by sysgen. , 


OPT 
indicates that task not established as a system task. 
PRES | 
indicates task is already present. 
ROTO 
indicates an I/O error in writing ROLL file. 
RVOL 
indicates an allocation or weet ounene error on roll file. 
SEG 


indicates that required library or task common is not 
present. 


SPAC 
indicates that there is not enough system space to complete 
load (for TCB). . | . 
SYS | 


indicates that there was not enough system space for segment 
descriptor entry. 


TKID 
indicates invalid taskid syntax. 
USE 


indicates an attempt to load a task common over one of the 
same name that is presently in use. 
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3-34 MARK COMMAND 
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The MARK command takes a device offline or brings online a device 
that was previously offline. For directory devices, the size of 
a volume’s secondary directory and the expansion size also can be 
specified with the MARK command. . 


Format: 


MARK dev:,) 


EF | ere | : 
PROTECTED oe . bsize exp 
ON |,< SYSTEM 1 -CDIRECTORY |= Doe, ot pe 
RESTRICTED , LUSS ) ane 


Parameters: _ 


dey: 
ON 
OFF 


PARAMETER 
RECL= 


SIZE= 


PROTECTED 


RESTRICTED= 
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PARAMETER[,RECL=recl] [,SIZE=size] 


is the device mnemanic. 
marks a device online. 
marks a device offline. 


indicates that the record length and forn size 
of a device are being modified. . 


recl is a decimal number from 1 through 132 
specifying the new record length for the 
output device. If this parameter is omitted, 


the default is 80. 


size is a decimal number from 1 through 88 - 


Specifying the form length for the output 
device. If this parameter is omitted, the 
default is 66. 


marks a device write-protected. 


actno is the account number of the owner of 
the restricted disk.e The disk is marked on 
with restricted access indicating that only 
the owner has access to it unless otherwise 
specified via the RVOLUMNE command under HTM. 


rs * 
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SYSTEM inhibits write access to a task running under 


MTN. 
CDIRECTORY ~ creates a secondary directory. 
bsize is the number of secondary directory entries 
' which will be contained in the memory-resident 
buffer for the secondary directory. The 


minimum buffer size is 20 file names (256 
bytes), the maximum size is limited to the 
“size of system space. If bsize is not 
specified, the default of 80 is used. A bsize 
of less than 20 will automatically iJefault to 
20. . 


/exp is the expansion size for the secondary 
directory file on disk. This is the number of 
files that can be allocated bafore the 
secondary directory file overflows. 


Functional details for marking a device on or off: 
The command is rejected if it is directed to: 


® the system console, 


e the NULL device, 


w 


@ a direct access device containing files that are currently 
assigned, or | 


e@ a device that is currently assigned. 


After marking on a direct access device, the volume name 
associated with it is output to the console device in the format 
device mnemonic: volume name, (e.ge, D300: M300). While a device 
is offline, it cannot be aSSigned to any u-task. E-tasks are 
permitted to assign offline devices. 


If the device being marked on or off is a direst access device, 
the fd used in the command is not the volume identifier, but the 
actual device mnemonic. For example, to mack off a disk named 
DSC1, which currently contains a volume named SYS, the operator 
enters: ; 


MA DSC1:,0F 
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This action removes the volume SYST from the systen. The disk 
can now be removed or changed if DSC1 is a removable cartriige 
disc. To make the new volume known to the system, the operator 
enters: | 


MA DSC1:,0N 


| This causes the volume descriptor of the pack on DSC1 to be read. 


.fThe volume id associated with DSC1 is output to the systen-. 


console. Removable cartridges should not be iismountel fron the 
system without marking then off. 


If the optional parameter PROTECTED is specified in a MARK: ON 


command, the device is Marked as write-protected. All 
assignments for access privileges cther than shared read only. 


(SRO) and shared read/write (SRW) are rejected with a privilege 
error. SRW is changed to SRO.w A WFILE (write filemark) command 
to any file on the device is also rejected. The PROTECT option 
can be used for any device regardless of the state of the 
hardware write-protect feature. The PROTECT option must be 
.specified for hardware protected disks. | ee oe | : 


If a direct access device is dismounted without being marked 
offline, it can be marked online only in the write protected 
mode. The Disk Integrity Check Utility must be run before. the 
volume can be marked online without the PROTECT option. [his 
ensures the integrity of files on a pack inadvertently 
dismounted. However, if the direct access device dismounted was 


originally marked online with the PROTECT option, the disk can be 


-remounted and marked online without the PROTECT option. 
If an I/O error occurs on a disk while the disk is beiag marked 
off, the following message is displayed on the system console: 


T/O ERROR MARKING OFF DISK ; PLEASE CHECK 


The disk is marked off and can be marked online only in the write 
protected mode. The Disk Integrity Check Utility must be run 


before the volume can be marked online without the PROTECT 


option. 

For direct access devices, file access time and consequently 
system performance can be optimized through the correct use of 
device directories. Three types of directories are available for 
use on direct access devices: 

» Default primary directory (disk resident) 


© Fast access primary directory (disk resident) 


e® Secondary directory (memory resident and disk resident) 
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A default primary directory is a noncontiguous director 


comprised of a series of 1-sector blocks. Each block can contai 


directory information for up to five files. These director 
biocks are allocated when needed as the number of files on a dis 


increases. When a directory block is filled, (five file 
allocated on the disk) another directory block is allocated o 
the next free sector encountered on the disk. This type o 


directory provides slow file access time due to the nontontiguou 
format of the directory and provides the least optimal fil 
access times. This type of directory is used by default if 


fast access primary directory or secondary directory is no 


specified. 


A fast access primary directory is allocated at jis 
initialization time via the BLOCKS= option of the Dis 
Initializer Utility (see the OS/32 System Support Utilitie 


Reference Manual). When = specified, the BLOCKS= optio 
preallocates a contiguous area on the disk to hold the primar 
directory. The capacity of the directory is based on the numbe 


of blocks specified. One block can hold directory informatio 
for five files. The contiguous format of this type of director 
results in faster access times in comparison to the nonc ontiguou 
format of the default primary directory. 


A secondary directory can be created when a disk is brough 


online via the MARK ON command. A secondary directory provide 


- Optimal access times and consequently, improved. syste 


performance by placing a directory of files on the disk direcstl 
into an in-memory buffer. File access operations then search. th 
in-memory directory for file directory information. When a dis 
is marked online with the secondary directory option specified 
a contiguous file called SYSTEM.DIR, large enough to hold al 
entries in the primary directory plus any expansion. size, i. 
automatically allocated on the disk. This file constitutes th 
secondary directory. The contents of SYSTEM.-DIR are the: 
transferred into an in-memory buffer, either all or in part 
depending upon the capacity of the buffer. [he capacity sf th 
buffer is specified via the bsize entry in this command: 


MARK disk:,0ON,,CD 


If the buffer capacity specified is equal to or greater than th: 
total number of file entries in SYSTEM.DIR, the entire content: 
of the secondary directory are placed into the memory buffer. 
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If the buffer capacity is less than the total number of file 
entries in the secondary directory, the contents of the directory 
are paged into the memory buffer during file access operations. 
Optimal system performance and access times are obtaineil if the 
memory buffer is large enough to contain the entire secondary 
directorye - . . Pos 


NOTE 


When . specifying the capacity of a 
secondary directory memory buffer for 
disks containing large numbers of files, 
the amount of memory used by the buffer 
can be prohibitive. Anticipate the size 
of the buffer- using the - following 


formula: 
memory space =~ bsize*256 
used (in bytes) 20 


Therefore, a _disk with 3,000 files 
requires 38.4kb of memory to accommodate 
the entire bia a directory: _ 


3000*256 = 38400 bytes = 38-4kb 
The following examples are presented to illustrate the 
relationship of the fast primary directory, the secondary 


directory, the secondary directory expansion. size, and the size 
of the in-memory secondary directory buffer. = 
Example 1: 


A disk volume contains 2,400 files and was initialized with a 
fast access primary directory of BLOCKS=550. Thus, the fast 


access primary directory contains space for 2,750 files (1 block 


equals 5 files). To establish an optimal performance seconiary 
Girectory, use the following command: 


MARK disk:,0N,,CD=2750/0 


This command allocates a secondary directory and gives the 
in-memory buffer the capacity to hold 2,75) file entries. No 
expansion capability is included. The memory buffer will use 
35.2kb of system SPacee ; 
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Example 2: 


A disk volume contains 2,100 files and was initializeil with a 
fast access primary directory of BLOCKS=400. The fast access 
primary directory has overflowed the preallocated size area by 
100 files. Assume that 500 additional files will be allocated on 
the disk before it is marked off. To establish an optimal 
performance secondary directory, the following command is used: 


MARK disk:,0N,,CD=2600/500 


This command allocates a secondary directory on the disk ani 
gives the in-memory buffer the capacity to hold 2,600 files. fhe 
expansion factor of 509 allows another 500 files to be allocated 
on the disk. The memory buffer will use 33.3kb of systam space. 


If many files are created on a disk that is marked on with a. 


small expansion factor, it is possible that the SYSTEM.DIR file 


may become full. Further attempts to allocate a file result in 
a secondary directory overflow, in which case a message: 


CDIR FULL-fd 


is displayed on the system console, where fd is the device 
mnemonic of the disk. This message is displayed only on the 
system consoles When secondary directory overflow occurs, the 
system starts using both the secondary and the primary 
directories when searching. for a file. In this case, file 
accessing time may be higher. To overcome this problem, the disk 
can be marked off and then marked on again with a desired 
expansion factor at a convenient time. A disk can also be marked | 
on protected and include a secondary directory, provided a good. 


SYSTEM.DIR file is present on that disk. 


Functional details for marking on a disk as restricted: 


When a disk is marked on restricted, the owner of the disk can 
allow other users to access it and can assign access privileges 
via the RVOLUME command under MTM. The Spooler and Backup are 
affected by this as shown in Table 3-6. For information on how 
MTM is affected, see the OS/32 Multi-Terminal ‘Monitor (MIM) 
Reference Manual. : 


3-84 48-030 FOO ROO 


TABLE 3-6 EFFECTS OF RESTRICTED DISKS ON SPOOLER AND BACKUP 
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assign error 
‘OCCULS. 


|} attempted, an assign 
@Lror occurs. yes Ne 


‘| READ/WRITE | | | | : | | 
ACCESS | READ ONLY ACCESS {| NO ACCESS | 
TASK | TO ACCOUNT O [| | TO ACCOUNT O | TO ACCOUNT 0 | 
<< SS SS SS SS SS SS SS SS = SS SS SS SE SS SS SS a | 
oSPL } All access | Files can be printed | Files cannot | 
{ is valid. | but not aeideon: If | be accessed. | 

| : | a delete is attempted, | | 

| | the system operator | { 

| |} receives the following | | 

| } message: » | | 

| | eSPL:SPL= =SVC 7 ERR= O7, | | 

1 |. fa 1 

| ae, i | | i. Oe as | 
BACKUP | All access | Verify ane option is | If access is | 
{ is valid. | valid. If backup is | attempted, an | 

ae ee eee | | 

“| | | | 


Functional details for modifying attributes of an output device: 


Specifying the PARAMETERS option indicates that the record Length 
and form size of an ASCII output device is being modified. The 
device being modified cannot be assigned. Modification to a 


pseudo device being used by the Spooler must be made by canceling 


the Spooler, specifying the new parameters, and restarting the 
Spooler. | | 


When modifying the attributes, either parameter can be specified. 
If both are omitted, an error occurs. 


Examples: 


MA DSC1:,0ON,P,CD verifies the primary directory with 
the existing secondary directory and 
allocates a secondary directory 
block size of as near to 89) files as 
possible. Expansion’ factor, if 

‘Specified, is ignored. . 


MA DSC%1:,0N,P,CD=200 attempts to create a secondary 


directory block size of as near to 
200 files as possible. 
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MA DSC1:,0N,R=4 marks a disk on restricted, allowing 
. only the owner of account 4 to have 
access to it. 


MA M300:,PA,R=65, S=56 changes the recori length and form 
size of volume 43003 to 65 
characters per line and 56 lines per 
page. 
Messages: 
BPAC-ERR 
indicates that a direct ‘access volume I/0 error was 
encountered. 


DEV-ERR 
| indicates that an attempt was made to mark ‘on or off a 
nonexistent device, or a pseudo device, or the NULL device; 
Or an attempt was made to modify the attributes of a 
nonexistent device or bulk device. . 
DUPL-ERR 
indicates that a duplicate device or volum2 name exists. 
FORM-ERR 
indicates a command syntax errore. 


NOFP-ERR 


indicates that an attempt was made to mark on a device not 
previously marked offline. 


PARM-ERR 
indicates an operand syntax error. 
READ-ERR 


indicates that the device is not hardware enabled, a hardware 
error exists, or a disk pack is bad. 


STAT-ERR 


indicates that the fd was already assigned or has file 
assigned. ‘ 


WRIT-ERR 


indicates that a device is hardware write-protected or djiis 
pack is bad. 
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If an attempt to mark a disk online with a secondary directory 
option fails, the disk is marked online without the secondary 
dixectory, and one of these messages is generated: 

FETCH ATTR ERR 


indicates that fetch attributes failed on secondary directory 
when marking protected with secondary directory. 


NO SYSTEM SPACE 


indicates that not enough system space was available for 
creating a secondary directory block. . 


Jo DIR READ ERR 


idicatee that an I/0 error was encountered when reading the 
primary directory. ae . 


/SEC-DIR ALLO ERR 
indicates failure to allocate sufficient space on the disk 
for creating new secondary directory, or disk is write 
‘protected (hardware feature). 


- SEC-DIR ASGN ERR - 


indicates that assignment to secondary directory failed 
during marking on protected with secondary directory. ~ 


SEC-DIR DELE ERR 

indicates that a DELETE command to old secondary directory 
failed because old file was not properly closed. [In this 
case, a disk integrity check should be run on that disk. 


SEC-DIR NOT PRESENT 


indicates that secondary directory does not exist on disk and 
mark on protected with secondary directory was attempted. 


SEC-DIR READ ERR - 


indicates that an I/O error was encountered when reading the 
seconiary directory during marking on in protected mode. 


SEC-DIR VERIFY ERR 
indicates that secondary directory failed to verify with the 
primary directory when marking protected with secondary 
directory. 


SEC-DIR WRIT ERR 


indicates that an I/0 error was encountered when establishing 
the secondary directory on the disk. f 
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3-35 MEMORY COMMAND 


The MEMORY command specifies the memory area (in kb) to 12 


designated 


local memory, or performs run time memor 


diagnostics on a specified memory area. 


‘Format: 


, Parameters: 


OFF 


address 


size 


{ OFF,address [size] 
ON,address [,size| 


TEST,address [-size] 


n 


marks off a page making that area unavailable 


This parameter also can be used to mark of. 
the following: = ma 


- an area from which a memory module is to bi 
removed, and 


- an area when an online test is to be rune 


marks On a memory block making that areé 
available. 


tests a marked off page for bad memory areas. 


is a positive decimal number from 1 through 
1024 specifying the size of local memory ir 
kbe The default value set at sysgen is 
overridden by ne. 


is a hexadecimal number specifying the 
starting address of the memory area to be 
marked off, on, or tested. | 


is a decimal number that is a multiple of the 
processor’s page size specifying the number of 
kilobytes in.memory to be marked off, tested, 
or marked one. If this Darameter is omitted, 
the default is one page. — 
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Functional Details: 


On Models 7/32, 8/32, and 3220 systems the block size is 256 


bytes; on 
2048 bytes. 


Hemory diagnostics consist 
testing. When initial memory 
operating system space and 
unavailable memory exists, it 
area is noted on the memory 
entered. . 


Models 3210, 3230, and 3240 systems the block size is 


time memory 
the LSU tests 


of initial and run 
testing is performed, 
then tests task space. [If bad or 
is marked off, and the marked off 
map when the DISPLAY MAP command is 


Before memory testing begins, the following message is displayed: | 


MEMORY TEST IN PROGRESS 


Memory testing is then performed on physical memory in block 
increments. (Any bad or missing memory is marked off. Adjacent 
marked off blocks are concatenated and labeled OFF MEMORY on the 
memory mape At the end of initial memory testing, a count of bad 
blocks is displayed: — Pav ae ae. | 


UNAVAILABLE MEMORY BLOCKS = nnnon 


The decimal count of bad blocks that have been marked off is 


nnnne Entering the DISPLAY MAP command displays the location and 
size of each block. At tne end of run time testing, the 
following message is displayed: . 

NO. OF BAD MEMORY BLOCKS = xxxx 


A count of zero 
tested arene If the 
When memory testing 


The decimal count of bad blocks is xxxx. 
indicates no bad memory was found in the 
count is nonzero, a memory map is displayede. 
is over, the following message is displayed: 


FND OF MEMORY TEST 
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The 


following approximate times for testing memory wi 


calculated on a 7/32 processor. The figures can be reduced by 
percent for other processors: 


oe The LSU requires 10 seconds to test memory and load 
standard operating system into 128kb of memory. 


® Initial memory testing requires 60 seconds to test Mb 
Memorye | 


'® Use of the test parameter requires 10 milliseconds to test. | 
of memory. 


The 


following four sections further describe functions of. nem 


diagnostics. 


Marking Off Memory 


If a memory parity error occurs during exec ution of au: 
task, the affected task is paused with its memory map addr: 


displayed when the DISPLAY MAP command is entered. | 


Use the OFF Sd aewer to mark off the bad memory area befc 
checkpointing and canceling the task. Failure to mark: 


the bad memory will cause the task memory to be destroys 


After the memory is marked of f and the task’ canceled, 1 
TEST parameter tests the marked off area. 


If a memory parity error or memory malfunction occurs on 
Perkin-Elmer 3200 Series processor and the operating syst 
is sysgened with memory test support (MEMCHECK), t 
operating system automatically marks off the affected ble 
from task space without operator intervention. When ths C 
parameter is entered, the required memory area must 
located in task or system spaces. If it is in system = spac 
above system space, or between system space, an address. 
size message is displayed and memory is not marked off. 
it is in system space, that area must be free or a nessagea 
displayed. 


Areas are marked off in memory starting with an address”) th 
is a multiple of the processor block size. A block ist 
smallest area that can be marked off. Rounding off is dc 
by dropping the least significant address bit. It is le: 
to mark off an area already marked off or nee Ree off pendir 
No errors are reported. ~ 


If the area to be marked off is in task space containing fr 
and allocated space, the required free space is marked of 
The required allocated space is flagged as marked c 
pending, and it remains marked off pending until released 
a terminated task. Then that area is automatically mark 
off. : 
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2e Marking On Memory _ 


Before memory is marked on a memory diagnostics test is 
performed. 


The described area must have been marked off or marked off 
pending and must be located within a single block. It is- 
legal to mark on only a portion of the marked off area. It 
is also legal to mark on an already marked on areae No 
errors are reported. 


Marked on memory is added to the free task or ‘free systen 
space. If the requested memory was marked off pending, the 
pending condition is removed. . 


Memory areas are marked on ster ing. with an saaeees that is 
a multiple of the memory block. size. A block is the smallest 
area that can be marked on. _ 


Ze Testing Memory 


The MEMORY command with the n parameter specified can he 
entered only when no tasks are in the system, before any 
disks are marked on with a secondary directory, and before 
setting a disk file as the log device. | os a - 


Ye. Specifying the Size of Local Memory 


The MEMORY command with the specified n parameter can be 
entered only when no tasks are in the system, before any 
discs are marked on with a secondary directory, and before 
setting a disk device as the log device. : 


Examples: 


MEMORY ON, 46600,2.25 marks. on memory UG6OO-46EFF (2.25kb) 
. ; for Models 7/32, 8/32, and. 3220 
PLOCceSSOLS. Marks on . memory 
HEOQOOQO-H6FFF  (4&kb) for the Mojiels 

3210, 3230, and 3240 processors. 


MEMORY OFF,3167E marks off an area 31600-316FF 
(0.-25kb) for the Models 7/32, 8/32, 
and 3220 processors. Marks off an 

“area 31000-317FFF (2kb) for 3210, 
3230, and 3240 PLOCeSSOLS. . 


MEMORY OFF,4663C,2.25 marks off an area K6E600-46EFF 
(2.25kb) for the Models 7/32, 8/32, 
and 3220 processors. Marks off an 
area 46000~-46FFF (4kb) for the 3210, 
3230, and 3240.processors. 
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The following sequence of commands illustrates 
marking on memory for the 


MEMORY TEST,46600,2.25 


*DISPLAY MEMORY 


(2.25kb) 
8/32 and 3220 


Tests an area 46600-46EFF 
for the Models 7/32, 
processors. Tests an area 
H6OO00-46FFF (4kb) for the Models 
3210, 3230, and 3240 processors. 


marking off and 


Models 7/32, 8/32, and 3220 processors: 


PRI 


NAME TYPES START SIZE SEG SYS STAT 
TASK MEMORY | 1D500 550.75 
OFF MEMORY 1D500 1-09 OFF 
OFF MEMORY | 1DBO0 0.50 OFF 
SYSTEM SPACE A70090 100.00 
*MEMORY ON,1D500 . 
NO. OF BAD MEMORY BLOCKS = 0 
*DISPLAY MEMORY | 
NAME TYPE START SIZE SEG sYs STAT PRI 
TASK MEMORY 1D500 550.75 ant oe 
OFF MEMORY 102600 0.75 OFF 
OFF MEMORY 1DBOO ~ 0.50 OFF 
SYSTEM SPACE A7000 100.00 
*MEMORY ON,1D700 
NO. OF BAD MEMORY BLOCKS = 0 
*DISPLAY MEMORY 
NAHE TYPE START SIZE SEG SYS STAT PRI 
TASK MEMORY 1D500 550.75 . 
OFF MEMORY 1D600 0.25 OFF 
OFF MEMORY 1D800 0.25 OFF 
OFF MEMORY 1DBOO0 0.50 OFF 
SYSTEM SPACE A7000 100.00 
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To merge marked off and marked off pending 


sequence 


of commands below. 


7/32, 8/32, and 3220 processors. 


*DISPLAY MEMORY 
NAME 
TASK MEMORY 
SYSTEM SPACE 
*TCOM TC1,0.25 
*TCOM TC2,0.25. 
*MEMORY OFF,1D500,0.5 
*DISPLAY MEMORY 
NAME 
TASK MEMORY 
TC1 
OFF MEMORY 
TC2 
OFF MEMORY 
SYSTEM SPACE 
* 


TYPE 


TYPE 


eS EG 


REM .SEG,TC2. 
-*DISPLAY MEMORY 

NAME 

TYPE 

TASK MEMORY 
TC1 
OFF MEMORY 
OFF MEMORY 
SYSTEM SPACE 
* 

REM .SEG,TC1 
*DISPLAY MEMORY 
NAME 
TASK MEMORY 

OFF MEMORY 
SYSTEM SPACE 


* 


e SEG 


TYPE 


.SEG. 


START 
1D500 
A7000 


START 


1D500 


1D500 
-1D500 
1D600 
1D600 


A7009 


START 
45500 
-4D500 


1D500 


~1D6090 
A7000 


START 


1D500 


—1D500 
A7000 


‘SIZE 
550.75 
0.25 


SIZE 
550.75 
100.00 


SIZE 
550.75 
0.25 
0-25 
0.25 
0225 
100.00 


0-25 
0.25 


100.00 | 


SIZE 
550-75 


0.50 


100.00 


SEG 


SEG 


SEG 


SEG. 


sys 


pages, follow the 


This example pertains to the Models 


SYS STAT. PRI 


SYS STAT PRI. 


- PEND 


PEND 


SYS STAT PRI. 


PEND 


OFF 


STAT PRI 


OFF 


This sequence of commands illustrates memory testing for the 
Models 7/32, 8/32, and 3220 processors. 


*DISPLAY MEMORY 

NAME TYPE 
TASK MEMORY 
OFF MEMORY 
SYSTEM SPACE 
*MEMORY TEST,1D500,4 
NO. 


A7000 


OF BAD MEMORY BLOCKS .= 3. 


ADDR SIZE 
BAD BLK 1D500 0.75 
GOOD BLK 1D800 1 
BAD BLK i1DCOO 1 
GOOD BLK 1 E000 1 
BAD BLK 1TE4O0 0.25 
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START SIZE S 

1D500 550.75 

1D500 4.00 
100.00 


EG 


SYS STAI PRI 


OFF 


Messages: 


FORM-ERR 
indicates a command syntax error. 

MEM-ERR 
indicates that n is less than UBOT, greater than physical 
memory, Or greater than the starting address of global task 
common. The system contains no memory available for systen 
spacee : 

MEM-ERR TYPE=ADDRESS 
indicates that address is outside task or system space. 


MEM-ERR TYPE=FIND 


indicates that requested system space is not free or 
requested memory is located in another segment. 


MEM-ERR TYPE=NOMD 


indicates that the MEMORY command was enterei, but the system 
does not support memory diagnostics. . 


MEM-ERR TYPE=SIZE POS=XXX 
indicates that calculated end address is betweeh task and 
system space or is outside system space. “XXX is the 
requested value. es. . 


MEM-ERR TYPE=SPAC 


indicates that insufficient system space exists to mark off 
the specified memory area; memory is not marked off. 


NOPR-ERR 

indicates that an operand is missing. 
PARM-ERR 

indicates that parameter is invalid. 
SEQ-ERR 


indicates that a system is not quiescent. 
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3.36 MODIFY COMMAND 


The MODIFY command is used to modify he contents of local or 
-Shared memory. 


‘Format: 


. data, Pe * 7 
MODIFY address |, 2 /data,rz,ecee,data, 
a€ g 
Parameters: 
address . 7 is the address ak gnten the contents of memory 
are to ae nodified. 
data | is a data field consisting of 0 to 4 


hexadecimal digits that represent a halfword 
to be written into memory starting at the 
location specified by addresse Any string of 

_ data less than four characters is 
right-justified and left-zero filleil. If the 
comma but no data is entered, 0 is entered . 
into one halfword. If data is omitted, a 
message is displayed. 


Functional Details: 


This command causes the contents of the halfword location 
specified by address (modified by any previous BIAS command) to 
be replaced with data. The modify address must be aligned on a 
halfvword boundary. 


Example: 
BI QO ‘modifies four halfwords at Location 
MOD 12F0,4,0,4,0 .12FO to contain 0004 0000 0004 0000. 
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Hessages: 


FORMN-ERR 
indicates a command syntax error. 

PAKM-ERR | | 
indicates an operand error occurred because an address was 
not aligned on a halfword boundary, an adiress spesified was 


not in memory or was reserved for MAC, or a specified address 
was Within the marked off section of memory. ; 
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-3.37 OPTIONS COMNBAND 
The OPTIONS command is used to specify or change certain options 


of the currently selected task. An OPTIONS command can be 
-entered if the referenced task is dormant or paused. 


Format: 


[carconr | ( RESIDENT ) | SVCCONTINUE 
aka : : ; - ‘ ee ’ Oe ®, ory naa! 


OOP ROS NE ati bas 


Parameters: 


AFCONT - specifies that if the arithmetic fault (AF) . 
| trap enable bit is set, a trap is taken. If 
‘the bit is not set, the task continues after 
arithmetic fault occurs ani the message is 
sent to the log device. a 


AFPAUSE specifies that the task is to pause after any 


arithmetic fault. 
RESIDENT specifies that the task is memory resident. 
NRESIDENT specifies chat the task is to be removed from 


memory at end of task. 


SVCPAUSE specifies that SVC 6 is treated as an illegal 
a SVC (applies to .BG only). If an SVC 6 is 
executed within a background task, the task is 

paused. 


SVCCONTINUE specifies that SVC 6 is treated as NOP 
{applies to .BG only). If an SVC 6 is 
executed within a background task, the task is 
continued. 


ROLL specifies that the task can be rolled. 


NROLL specifies that the task cannot be rolled. 
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Functional Details: 


Unless otherwise specified with the Link OPTIONS commani, when a 
task is loaded, the default options are: AFPAUSE, NONRESIDENT, 
_SVCPAUSE, and ROLL. If accounting is enabled in the system, 
ACCOUNT also becomes a default option for a task. An OPTIONS 
ROLL command is invalid unless the directed task is linked as 
rollable. 


_if conflicting options are specified, the latest option entered 
is accepted. Thus, OPTIONS RESIDENT, NRESIDENT specifies 
NRESIDENT. . | 


The AFPAUSE and AFCONT options are normally set up at Link time, 
but the console operator can modify then. 


The sequence TASK taskid, OPT NRESIDENT, and CANCEL taskid always 
causes the currently selected task to be removed from memory. 
The sequence TASK taskid, OPT RESIDENT, and CANCEL taskid alway: 
causes the currently selected task to enter the dormant state. 
The SVCPAUSE and SVCCONTINUE parameters apply only to % 
background task. They are ignored if they are specified for i 
foreground task. 


If an OPTIONS NROLL is directed to a task currently rolled out, 
the option goes into effect after the task is rolled into memory 


If any parameter is invalid, previous valid parameters in th 


same command are processed. In this case, the DISPLAY PARAMETER: 
command can be used to verify the state of the task options. 


Messages: 


FORM-ERR 

indicates a command syntax error. 
NROL-ERR 

indicates invalid option; task not rollable. 
OPT-ERR 


indicates invalid option; roll option not specified at Lin 
time. . 


PARM-ERR 


indicates an operand syntax error. 
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SEQ-ERR 


indicates that task is not dormant or paused. 


TASK-ERR 


indicates -that there is no currently selected task. 
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3.38. PAUSE COMMAND 


The PAUSE command causes the currently selectei task to pause. 
_ Formats 

PAUSE 
Functional Details: 


Any I/0 proceed, ongoing at the time the task is paused, is 
allowed to continue to completion. If the task is in any wait 
state at the time the PAUSE command is entered, all external wait 
conditions must be satisfied before the pause becomes effective. 
This command is rejected if the task is dormant or paused at the 
time it is entered. — | 


Messages: 


FORN-ERR 

indicates a command syntax error. 
SEQ-ERR 

indicates that task is paused or dormant. 
TASK-ERR | 


indicates that there is no currently selected task. 
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3.39 REMOVE COHHAND 


The REMOVE command is used to remove fron memory a shared segment 
that is loaded by a LOAD command or established by a ICOM 
command. The memory area it occupied is freed for system use. 


| Formats 
REMOVE .SEG,segment name 


Parameters; 


oSEG specifies that a shared segment is to be 
removed. 
segment name is the symbolic name of the shared segment. 
Messages: 
FORM-ERR 


indicates a command syntax error. 
PARM~ERR 

indicates an operand syntax error. 
REM-ERR 


indicates an attempt to remove a segment failed for reason 
noted in TYPE field. 


REM error TYPE field responses: 


NAME 
indicates that shared segment name does not exist. 
RMV 


indicates that task common to be removed is a global task 
common that is not removable. 


USE 


indicates that shared segment is presently in use. 
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3-40 RERAME COMMAND 


The RENAME command is used to change the name of an unassigned 
direct access file or device. 


Formats 
ENAME oldfd,newfd 
Parameters: 


oldfd is the current file descriptor of the File or 
device to be renamed. 


newfd is the new file descriptor to which the file 
or device is renamed. 


Functional Details: 


The volume id field of the new file descriptor (newfd) can be. 
omitted for direct access files. If it is entered, the system 
ignores it. This command cannot be used to rename a direct 
access volume; the disk initializer must be used for this. 
Attempts to rename the console device or the null device or to 
rename areal or a pseudo device to an existing davice or volume 
result in an error. A file can only be renamed if its write and 
read protection keys are 0 (X'9000°). 


By specifying different account humbers in the oldfd and newfd, 
a file can be logically transferred from one user to another (the 


file is not copied). Files in account 255 cannot be transferred 
in this waye 


Examples: 
REN VOL: AJM.~CUR,AJM.NEW° renames file AJM.~CUR to AJM.NEW on 


volume VOL. 


REN NTO1:,MTO2: renames device MTO1 to MT0O2. 
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Messages: 


ASGN-ERR TYPE=PRIV POS=REN 


indicates that fd is currently assigned, Or the RENAME is 
directed to the system console. . 


ASGN-ERR TYPE=PROT POS=fd | 


indicates that protection keys are nonzero. 


FD-ERR 


indicates an invalid fd. 


FORM-ERR 


indicates a command syntax error. 


NOPR-ERR 


indicates that a required parameter is missing. 


NULL-ERR 


indicates an attempt to rename the null device. 


PARM-ERR 


indicates an operand syntax error. 


RENM-ERR TYPE=BUFF POS=fd 


indicates that an error occurred when closing an lu for a 
RENAME, or the system space control blocks are corrupted. 


RENM-ERR TYPE=NAME POS=REN 


indicates that a duplicate device or volume name exists. 


RENM~ERR TYPE=NAME POS=fd 


indicates that a duplicate filename exists. 
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3-41 REPROTECT COHHAND 


The REPROTECT command permits the operator to modify the 
protection keys of an unassigned direct access file or ilevice. 


Format: 


REPROTECT fd,new keys - 


Parameters: 
fd is the file descriptor of the file or device 

to be reprotected. 
new keys is a hexadecimal halfword whose left byte 


signifies the new write keys and whose right 
byte signifies the new read key. 


Functional Details: 


A file with a nonzero account number also can be reprotected 
(account number field must be specified in the fd). This 
facility is provided mainly to enable changing the keys to 0. so 
that a nonzero account number file can be renamed or deleted. 
Unconditionally protected files or devices can be coniitionally 
reprotected or unprotected. See the ASSIGN command, Section 3.3. 


Messages; 


ASGN-ERR. 


indicates that reprotect failed for reason noted in [TYPE 
field. 


FD-ERR 
indicates an invalid fd. 
FORM-ERR 


indicates a command syntax error. 
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PARM-ERR 
indicates 


PRIV-ERR 


indicates 


REPR-ERR 
indicates 
field. 


-ASGN and REPR 


NAME 
indicates 
PRIV 
indicates 
VOL 


indicates 
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an Operand syntax error. 
an attempt to reprotect a pseudo spool device. 
that reprotect failed for reason noted in f[YPE 


error TYPE field responses: 


that fd does not exist on specified volume. 
that fd is currently assigned. — 


that volume or device does not exist. 
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3-42 REWIND AND RW COHMANDS 


Tne REWIND and RW commands rewind magnetic tapes, cassettes, a1 


direct access files. This command is entered from the syst 
console. 
Formats: 
REWIND £4 <i Used for magnetic tapes and 
or cassettes only 
RW fd_ 
REWIND fd [,1u] ; Used for disk devices only 


or , 
RW fd [-1u] 


Parameters: 
fd is the file descriptor of the device or fi 
. to be rewound. 
Lu is the Logical unit to which the device 


file is assigned. 


Functional Details: 


For magnetic tapes and cassettes, only the parameter fd should 
specified; for direct access files, lu optionally can 
specified. The account number must be 0 if specified. 


Before entering the format for disk devices, the task must 
selected as the current task through the TASK command. 


Examples: 
REW MAG1: causes the tape on device MAG1: 
‘be rewound. 
REW M300:AJM.OBJ,4 causes file AJM.OBJ, as assigned 


lu 4 on volume M300, to be reywoun 
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Messages: 


ASGN-ERR 
indicates that the file or device could not be assigned for 
the reason noted in the TYPE field. See Appendix B for 
possible entries in the TYPE field. 


FD-ERR 


indicates an invalid fd or the file has a nonzero account 
number. 


FORM-ERR 
indicates a command syntax error. 
IO-ERR 


indicates that an I/O error or an illegal or unassigned lu 
Was encountered on the specified device or file. 


LU-ERR 


indicates that an invalid fd was encountered or 3a nonzero 
account number was specified 


NOPR-ERR 
indicates that no operand was specified. 
PARM-ERR 
indicates an operand syntax error. 
TASK-ERR 
paieaeed that there was no currently selected task and a 
REWIND command with lu specified was entered. 


ASGN error TYPE field responses: 


NAME 

indicates that fd does not exist on specified volume. 
PRIV 

indicates that file or device is already assigned. 


VOL 


indicates that volume or device does not exist. 
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3.43 RVOLUME COMMAND 


The RVOLUME command allows the system operator to display to the 
system console the accounts that have access to a privately owned 
restricted disk. 


Format: 


Parameterss 
voln | is the volume name of the restricted disc. 
Functional Details: 


When an operator displays the accounts having access to 32 
privately owned disk, the accounts are displayed at the system 
console along with their access privileges. 


Examples: 

RVOL M300 

OWNER = 20 

O/RO 20/RW 22/R0 36/RO 80/RW 88/RW 
Messages: 
PEREM-ERR 


indicates a parameter is missing or invalid. 
PRIV-ERR 

indicates that the accessed disk is not a restricted disk. 
VOLN-ERR 


indicates that the volume is not online or the volume name is 
invalid e 
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3.4% SEND COMMAND 


The SEND command is used to send a message to the currently 
selected task. 


Pormat: 


SEND message[;] 
Parameter: 


message is a variable length string of 1 to 64 
alphanumeric characters. 


Functional Details: 


The message iS PDassed to the selected task in the Same manner as 
an SVC 6 send message. Following standard SVC 6 procedures, the 
message consists of an 6&8-byte taskid identifying the system 
manager, followed by the operator-supplied character string. [The 
message data passed to the selected task begins with the first 
nonblank character following SEND and ends with a carriage return 
oer semicolon (3) as a line terminator. A message cannot be sent 
to a task currently rolled out. 


The receiving task must have intertask message traps anabled in 
its TSW and must have established a message buffer area. Since 
background tasks cannot have intertask message traps enabled, a 
message cannot be sent to a task in the background. Refer to the 


OS/32 Supervisor Call (SVC) Reference Manual for more information 
on the send message function (SVC 6). 


Examples: 


TASK ANITA 
SEND CLOSE LU2,ASSIGN LY3 


produces the following message for the task ANITA: 


~CHDP CLOSE LU2, ASSIGN LU3 
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Messages: 


ARGS-ERR 
indicates that a message exceeded 64 characters. | 
NOPR-ERR 


indicates that no message was provided. The first nonblank 
character following the SEND command was a carriage return. 


SEQ-ERR 


indicates that task is paused, not yet started, or not 
capable of receiving a message. 


SVC6é-ERR 


indicates that an SVC 6 error was returnei specifying tha 
the task could not receive a message trap. 


TASK-ERR 


indicates that there was no currently selested task. 
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3.45. SET LOG COMMAND 

The SET LOG command is used to specify the system log device. 
The system log device receives ail system console I/O. This 
includes: , 

® all command lines entered from the console or from the CSS, 


e all responses to these commands (other than prompts), and 


e@ all messages logged by tasks. 


Format: 


sEt Loc [ea] [,copy] 1 


Parameters: 


fd is the file descriptor of the log davice. 
Account number must be 0 if specified. 


COPY specifies that a copy of all system console 
I/O is to be sent to the log device. 


n is a decimal number from 0 to 65,535 
specifying the number of lines after which the 
system log file is to be checkpointed. If 
this parameter is omitted, the default is 15 
lines. 


Functional Details: 


If COPY is specified, the system console continues to raceive all 
system console I/O and a copy is sent to the log devicee If COPY 
is not specified, the system console receives nothing. 


Checkpointing is only m2aningful for indexed files on disk. Tf 
n is specified as 0, no checkpointing occurs. If n is omitted, 
the default is 15 lines. This ensures that any lines not 


checkpointed will not be visually lost and can b2 manually 
recorded by the operator if necessary. 
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The log device can be shared with user task output. 
changed at any time by another SET LOG command. If 
are specified, logging is terminated. Logging is 
terminated under these conditions: 

6 1/0 error on the log device 


e System initialization 


® Power restoration 


It can = be 
no parametars 
automatically 


device 


When logging is terminated, the system console again 

receives all output. 

SET LOG is primarily used for: 

e providing a historical record of system op2ration, often on 
magnetic tape or direct access file; and 

e® allowing system output displays, log massages, etc. to 


proceed on a high-speed 
console. 


Example: 


device 
sends a 
I/0 


SET LOG PR:,COPY sets the log 
(PR:), and 
system console 


device. 
Messages: 


ASGN-ERR 


log device or file could not 


offline or 


that a 
device 


indicates 
that is, 
task. 
FD-ERR 
indicates an invalid fd. 
IO-ERR 
indicates 
PARM-ERR 
indicates 


an operand or command syntax error. 
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to a 


to 


device rather than on the systen 


printer 
of all 


copy 
the log 


be assigned: 


assigned for exclusive use to 


that I/O error occurred on output device or file. 
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3-46 SET PRIORITY COMMAND 


The SET PRIORITY command is used to modify the priority of the 
currently selected task. 


Format: 
SET PRIORITY n 


Parameters: 


n is a decimal number fron 10 through 249 
specifying the new priority for the currently 
selected task. 


Functional Details: 


The priority of the currently selected task is set to n, subject. 
to this restriction. If the task is a foreground task, its 
priority cannot exceed the maximum priority set when the task was 
built. To increase the maximum priority, reestablish the task. 
The maximum ooriority a background task can attain is set at 
sysgen. To increase this priority, resysgen the system. The 
default priority for all tasks is 128. 


Example: 
TA ABC sets the priority of task ABC to 
SET PRI 150 150. 


Messages: 


FORM-ERR 
indicates a command syntax error. 
NOPR-ERR 


indicates that required parameter n was onitted. 
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PARM-ERR. 
indicates a parameter syntax errore 
PRTY-ERR 


‘indicates that new priority is greater than maximum priori: 
specified at Link time. 


TASK-ERR 


indicates that there was no currently selected task. 
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3-47 SET SLICE COHMAND 
The SET SLICE command is used to invoke the time-slice scheduling 
option. 


Format: 


SET SEICE no 


Parameter: 
n is zero or 2 decimal number from 20 to 65,536 
specifying the time slice allocated to each 
task. 


Functional Details: 


If nis 0, time-slice scheduling is disabled; otherwise, non 
represents the maximum time in milliseconds that any one task can 
remain active if another task of equal priority is ready. The 
time-slice option is initially disabled. 


Two types of scheduling algorithms are available. Tasks can be 
scheduled in strict priority order or time sliced within 
priority. In the former case, if two tasks of equal priority are 
Started, a task remains active until it relinquishes control of 
the processor. Assign priorities carefully so that tasks that do 
not frequently relinquish . control of the processor do not 
inadvertently lock out other tasks. A task can rcelinquish 
control in one of the following ways: 


® Task is paused by the console operator. 


® Task is cancelled by the operator or another task. 


e A higher priority task becomes ready because of some external 
event. : 


® Task executes an SVC that places it in wait, pause, or dormant 
state. 
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Rather than scheduling on a strict priority basis, tasks can be 


time sliced within priority. This option allows the user to 
ensure that tasks of equal priority receive equal shares of 
processor time. When a task becomes ready, it is gqgueuvei on a 


round-robin basis behind all ready tasks of equal priority. 


Examples: 

SET SLICE 20 . sets the maximum time that a task 
can remain active to 20 milliseconds 
if another task of equal priority is 
ready. 

Messages: 
FORM-ERR 


indicates a command syntax error. 
NOPR-ERR 


indicates that operand n was missing. 


PARM-ERR 


indicates that overand n is not 0 or a decimal number withir 
the required bounds. 
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3-48 SET SYS COMMAND 
The SET SYS command is used to vary the size of system sSpace.. 


System space is usei to hold system control blocks and buffers 
(TCBs, FCBs, etc.). 


Formats: 


SET SYS na 


Parameters: 


n is a decimal number from 0.25 through 16,384 
specified in increments of .25kb. The value 
n is rounded up to the next page boundary. . 


Functional Details: 


This command is rejected if insufficient memory is available. It 
is also rejected if a decreasSe in system space size is requested 
and the current usage exceeds the new size. It is accepted 
whenever contiguous memory is available to accommodate the 
request. The SET S¥S command cannot cause a rollout of any task. 


The OS/32 data structures and FCB requirements for each are: 


Contiguous files 230 bytes 


Indexed files | 528 + blocking factor x 512 + index 
block factor x 256 


Tiner queue entries 24 bytes 
Task control blocks 560 + 4&4 x maximum number of logical 


units + 12 x number of accounting 
‘I/O classes 
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Exanple: 


SET SYS 75.25 adjusts the amount of system SE 
{ | available to 75.25kb for a Ma 
| 7/32, 8/32, or 3220 system. On 
{ 3210, 3230, or 3240 system 
amount of system space is adjus 
to 76kb. 


Messages? 


FCRM-ERR 
indicates a command syntax error. 
} MEM-~ERR POS=XXX 
| indicates insufficient memory. XXX is the requested value. 
NOPR-ER&R | 
indicates required operand is missing. 
PARM~ERR 


indicates an operand or command syntax error, or that on 
not a decimal number specified in increments of .25kb. 
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3.49 SET TIME COHMAND 


The SET TIME command sets the current date and time of day. 


Format: 
{mm/dd/yy] ,-hh:nn:ss 
SET TIME OFF 
0 
Parameters: 
mm is a decimal number from 01 £4xthrough 12. 
specifying the month. 
dd is a decimal number from 01 through 31 
specifying the day. 
yY is a decimal number from 00 through 99 
specifying the year. 
hh is a decimal number from 00 through 23 
specifying the hour. 
nn is a decimal number fron 00 through 59 
specifying minutes. 
ss is a decimal number from 00 through 59 
specifying seconds. 
OFF turns of £ the clock for system debugging. 


0 turns off the clock for system debugging. 
Functional Details: 


The SET TINE command must be entered when the system is first 
loaded and after any power failure occurs. [t may be entered 
whenever the system clock is incorrect. The day, month, and year 
are automatically updated by the system (even during leap years). 
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At system initialization, following the display of the operatin 
system id, this message is output to the system console: 


ENTER DATE AND TIHE 


If a command other than SET TIME is entered, the prompt ENTE 
DATE AND TIME is repeated until a SET TINE command is entered 
If a SET TIME command is entered while incomplete time interval 
exist, the tasks that initiated the incomplete intervals ar 
affected in these ways: 


e Seconds from midnight - The time and day are updated; however 
this has no effect on any time of day interval even if th 
date entered differs from the date previously entered. Th 
time difference is used to adjust all seconds from midnigh 
intervals. 


e Milliseconds from now - Elapsed time intervals are unaffecte 
by a change in the time by a SET TIME. 


For example, if the Sieront date is 11/22/80 aa the current tin 
is 11:50 AM, and there are three intervals outstanding: 


1. Time of day interval is set to complete on 11/22/80 at 2:0 
PM. 


2. Time of day interval is set ‘to complete on 11/23/80 at 8:0 
AM. 


co Elapsed time interval is sat to complete on 11/22/89 at 1:3 
PH. 


If SET TIME 11/21/80, 10:50:00 is entered, the time intervals ar 
as follows: 


1. Time of day interval is set to complete on 11/21/80 at 2:C 
PM. 


2- Time of day interval is set to complete on 11/22/80 at 8: 
AM. 


3. Elapsed time interval is set to complete on 11/21/80 at ‘1 
noone 


When the system is restarted after a power failure, the clock i 
automatically turned on, and the date and time at the time c 
power failure is used. The operator should correct the tin 
after the power failure. 
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During system debugging, it is often desirable to eliminate 
interrupts. The SET TIME command provides the system debugging 
feature. This feature is performed by entering: 


(0. 
SET TIME 
| OFF 


System debugging mode may be selected at any time. When this 
mode is selected, the clock is turned off, clock interrupts are 
inhibited, the display panel is cleared, and the previous date 
and time setting (if previously set) is cleared. The operator 
may exit from this mode at any time by entering SET TIME with the 
desired date and time specified. 


Example; 
SET TIME 2/24/80,03:05:00 


Alternatively, by sSysgen option, the date parameter can be. 
entered in the format: 


dd/mm/yy 


The date parameter is optional only if it has been previously 
set. Therefore, at system start-up, both the date and time must 
be specified. 


Messages: 


FORM-ERR 

indicates a command Syntax error. 
NOPR-ER® 

indicates that an operand is missing. 
PARM-ERR 


indicates an operand syntax error. 


48-030 FOO ROO 3-121 


3-50 START COMHAHD 


The START command is used to initiate task execution. 
currently -selected task is started only if it is dorma 
otherwise, the command is rejected. 


Format: 


address 
START | 4. [-parameter,,.--/parameter, | 


Parameters: 


address specifies the address at which task execut 
is to begin. For u-tasks, this is ne 
physical address, but is an address within 
task's own program. For actasks, it is 


physical address. If address is omitted, 
currently selected task is started at 

transfer address specified when tha task 
established. | 


parameter specifies optional parameters to be passed 
the task for its own decoding and processi 
Each parameter must be separatad by a cor 
All characters between the comma and 
command terminator (carriage. return 
semicolon) are moved to memory beginnin: 
UTOP. The characters are terminated in mer 
by a carriage return. If this operand 
omitted, a carriage return is stored at U' 
If there is not enough memory between UTOP 
CTOP to pass all the characters, the call 
rejected with an ARGS-ERR. 
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Examples: 


ST 138 starts the currently selected 


task 


task 


at X*138". 
ST 100,NOSEG,SCRAT starts the currently selected 
i at X°'100° and passes NOSEG,SCRAT to 
the task. 
ST ,1000,ABC Starts the currently selected 


task 


at transfer address specified when 


the task was built and 
1000,ABC to the task. : 


Messagess 


FORM-ERR 

indicates a command syntax errors 
PARM-ERR 

indicates an operand syntax error. 
SEQ-ERR 

indicates that task is active. 
SVC6-ERR TYPE=ARGS | 


indicates insufficient memory between UTOP and CTOP to 
all parameters. 


SVC6-ERR TYPE=DORM 


passes 


PASS 


indicates a START was entered but task is in time delay wait. 


TASK-ERR 


indicates that there was ho currently selezsted task. 
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3.51 TASK COMMAND 


The TASK command is used to specify the current foregrou 
background, or system task. : 


Format: 
TASK [taskid] 
Parameters: 


taskid is the name %f a foreground task, backgro 
task (.BG), or a system task (.MTM or .SP 
If taskid is not specified, the taskid of 
currently selected task is displayed on 
console device... 


Functional Details: 


Task-related commands operate on the currently selected ta 
All task-related commands are affected by the TASK command. A 
affected are the BFILE, BRECORD, FFILE, FRECORD, REWIND, RW, 

WFILE commands. Some CSS commands are affected by TASK 

described in Chapter 5. . 


NOTE 


When CSS is started, the current value of 
TASK is associated with the CSS file as 
the currently selected CSS task. If a 
CSS file axecutes a TASK command, it 
affects only that CSS file’s commands and 
does not change the value of TASK 
associated with the console. 


If the currently selected task is deleted from the system, or 
no TASK command has been entered, task-related commands (ot 
than TASK) are rejected with a TASK-ERR®. 
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Example: 


T ABC 
CL 2,3,4% 


AS 2,CARD: 


Sets current task to ABC. 

Closes logical units 2, 3, ani 4 of 
task ABC. | . 

Assigns lu 2 of task ABC to device 
CARD. 


[T XYZ Sets current task to XYZ. 

OPT RES Makes task XYZ resident. 

CAN XYZ Cancels task XYZ. 

ST 100 Starts task XYZ at relative address 

100. 

T .BG Sets current task to background. 

PAUSE Pauses the background task. 
Messages: 
PARM-ERR 


indicates an operand syntax errore 
TASK-ERR 


indicates that there was no currently selected task. 
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3.52 TCOM COMMAND 


The TCOM command is used to allocate an area of memory for a 
local task common segment to be referenced by user tasks. 


Format: 


TCOM segment nhame,segment size 


Parameters: 


segment name 


segment size 


Functional Details: 


is the symbolic name of the common block used 
by programs in referencing the common segment. 


is the size of the memory area to ~=hbe 
allocated. Size is a positive decimal nanber 
in kb, specified in multiples of 256-byte 
increments for the Models 7/32, 8/32, and 3220 
processors or 2048-byte increments for the 
Models 3210, 3230, and 3240 processors, with 
the maximum value depending on the available 
task space. 


The segment is resident until removed via the REMOVE command. 


Exampless 
TCOM COM1,2.5 


TCOM COMN2,20 


S126 


allocates a 225kb task common 
segment COM. 


allocates a 20kb task common segment 
COMM2. 
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Hessages:?: 


FORM-ERR 

indicates a command syntax error. 
PARM-ERR 

indicates an apenane syntax error. 
~TCOM-ERR 

indicates that creation of task common Seqment:. failei for 

reason noted in TYPE field. | 
TCOM error TYPE field responses: 
MEM 

indicates that theve is no vacant area of sufficient size. 
NAME 

indicates that task common of same name already exists. 


S¥5 


indicates that there is not enough system space for required 
segment descriptor entry. 
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3.53 TEMPFILE COMMAND 

The TEMPFILE command causes a temporary file to be allocated a3 
assigned to one of the logical units of the currently select: 


task. A temporary file exists only for the duration of tI! 
assignment. When a temporary file is closed, it is also delete: 


Formats 


CONTIGUOUS, fsize :? - i 


TEMPFILE lu, lrecl (bsize isize 


. Parameters: 


CONTIGUOUS specifies the file type to be allocated 
contiguous. 
fsize is a decimal number specifying the tot: 


allocation size in 256-byte sectors. “Th: 
‘Size can be any value up to the number °° 
contiguous free sectors existing on tl 
specified volume at the time the command 
entered. 


INDEX specifies the file type to be allocated 
index. 
lrecl is a decimal number specifying logical reco! 


length in bytes. It cannot exceed 65,5. 
bytes; its default is 126 bytes. 


bsize is a decimal number specifying the physic: 
block size in 256-byte sectors, to ba used fi 
buffering and debuffering operations on ti 
file. If bsize is omitted, the default vali 
is 1. The bsize parameter cannot exceed tl 
maximum block size established at sysgen. 


isize is a decimal number specifying the index blo: 
size in 256-byte sectors. If isize 
onitted, the default value is 1. The isi: 
Parameter cannot exceed the maximum block Si: 
established at sysgen. 
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Functional Details: 


A temporary file is allocated on the default TEMP volume. Refer 
to Section 3.53 for information on the TEMP volume. 


To assign an index file, sufficient room must exist in system 
space for three buffers, each of the stated size. Therefore, if 
bsize or isize is very large, the file cannot be assignad in some 
memory-bound situations. At sysgen, a maximum block size 
_ parameter is established in the system, and bsize and isize 
cannot exceed this constant. 


Examples: 


TE 2,C0,64 | ) allocates on the default temporary 
volume a contiguous file with total 
length of 64 sectors (16kb) and 
assigns it to. lu 2 of the currently 
selected task. 


TE 14,1N,126 allocates on the default temporary 
. volume an index file with logical 

record length of 126 bytes. The 

butfer size and index block size 

default to one seztar. The file is 


assigned to lu 14 of the currently 
selected task. 


Messages? 


ALLO-ERR 


indicates that allocation failed for reason denoted by TYPE 
field. — 


ASGN-f£RR 
indicates that the assign failed for reason noted by the TYPE 
field. See Appendix B for possible entries in the TYPE 
field. 

FORM-ERR 
indicates a command syntax error. 

LU-ERR- 


indicates an invalid lu number or lu assigned. 
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NODA-ERR 


indicates 
system. 


NOPR-ERR 
indicates 

PARM-ERR 
indicates 

SEQ-ERR 

| indicates 

SPAC-ERR 


indicates 
usagjee 


TASK-ERR 


indicates 


3-13G 


that direct access support is not included in this 


a required operand is missing. 
an operand syntax error. 
that currently selected task is not dormant. 


that task exceeds established maximum system space 


that there is no currently selected task. 
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3-54 VOLUME COHMAND 


The VOLUME command is used to set or to change the namn2 of the 
system, task, roll, spool, or temporary volume. Alternatively, 
it is used to interrogate the system for the current names 
associated with these volumes. 


Formats 
SYSTEM 
TASK 
TEMPORARY 
VOLUME | voln|/ 
SPL 


Parameters: 


voln . is a 4-character volume identifier. If all 
parameters are omitted, all current systen, 
task, roll, spool, and temporary volume names 
are displayed. 


SYSTEM . specifies the system volume. 


TASK specifies the task volume of the currently 
selected task. 


TEMPORARY specifies the temporary volume. 


SPL specifies the spool volume. 
ROLL specifies the roll volume. 


Functional Details: 


Any comnands that do not explicitly specify a volume name use the 
system volume as a default. No test is made to ensure that the 
volume is actually online at the time the command is entered. If 
voln is not specified, the names of the current default volumes 
are output to the console device. oe 
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Examples: 
VOL ABCD/SPL 


V. 
SYSTEMV=MT4 
TASKVOL=HT4 
TEHPVOL=FIXD 
SPOOLVY =FIXD 


ROLLVOL=FIXD 


Messages: 


NODA-ERR 


establishes volume ABCD as a_e spool 


volume. 


displays all current volume names to 
the console. 


(will be 
included 
(will be 
included 


displayei if spool support 
at sysgen) 
displayei if roll support 
at sysgen) 


indicates that no direct access support was sysgenei. 


. PARM-ERR 


indicates an operand syntax error. 


TASK-ERR 


indicates that there is no currently selected task. 
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3.55 WFILE COMMAND 


The WFILE command writes a filemark on magnetic tapes, cassettes, 
and direct access files. The command is entered at the system 
console. 


Formats: 
WFILE fd Used for magnetic tapes and 
cassettes only 
WEILE £4 [,1u] Used for disk devices only 


Parameters: 
fd is the file descriptor of the file or device 
to which a filemark is to bea written. 
Lu is the logical unit to which the jevice or 
file is assigned. 


Functional Details: 


For magnetic tapes and cassettes, only the parameter fd should be 
specified; for direct access files, lu optionally can be 
specified. The account number must be 0 if specified. 


Before entering the format for disk devices, the task must be 
selected as the current task through the TASK command. 


Examples: 
WP MAG7: causes a filemark to be written on 
the magnetic tape on MAG1:. 
WE M300:AJh.OBJ,4 - causes a filemark to be written on 


file AJM.OBJ, which is assigned to 
iu & on volume M300- 
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Messages: 


“ASGN-ERR 


indicates that the file or device could not be assigned for 
the reason noted in the TYPE field. 


FD-ERR 

indicates an invalid fd. 
FORM--ERR | 

indicates that a command syntax error was encounterad., 
IO-ERR 


indicates that an I/0 error or an illegal or unassigned lu 
was encountered on the specified device or file. 


LU-ERR 
indicates that an invalid lu was encountered. 
NOPR-ERR 
indicates that no sperand was specified. 
PARM~-ERR 
indicates that an operand Syntax error was encountered. 
TASK-ERR | 


indicates that there was no currently selected task and a 
WFILE command with lu specified was entereli. 
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3.56 XALLOCATE COMMAND 


The XALLOCATE command deletes an existing file and allocates a 
file with the same name. 


Format: 


XALLOCATE fd, 


Parameters: 


fd 


CONTIGUOUS 


fsize 
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keys 
CONTIGUOUS, fsize |, 
So0s: 


Heoe 


is the file to be deleted and the name of the 
new file to be allocated. 


specifies that the file type to be allocated 
is contiguous. 


is a decimal number indicating file size, 
which is required for contiguous files. [t 
specifies the total allocation size in 
256-byte sectors. This size may be any value 
up to the number of contiguous free sectors 
existing on the specified volume at the tine 
the command is entered. 


specifies that the file typs to be alilocateil 
is index. 


is a decimal number specifying the logical 
record length of an index file or data 
communications device. Tt cannot exceed 
65,5935. bytes. Its default is 126 bytes. It 
may optionally be followed by a slash (/), 
which delimits lrecl from bsize. 
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bsize is a decimal number specifying the physical 


block size to be used for puffering 
debuffering operations on the index fil 
data communications device. When IND 
specified, bsize represents the blozsksiz 
sectors. When ITAM is specified, 

represents the buffer size in bytes. 

parameter cannot exceed the maximum block 
established at sysgen. If bsize is oni 
the default value is one sector (256 byte 


isize isa decimal number specifying the index 
Size. If isize is omitted, the default 


is one sector (256 bytes). Like bsize, 
cannot exceed the maximum block 
established at sysgen; and in any 


neither operand can exceed 255. 


ITAM specifies that the device to be allocate 
a data communications device. 


keys specifies the write and reali protection 
for the file. These keys are in the fo 
a hexadecimal halfword, the left byta of 
Signifies the write key and the right 


the read key. If this parameter is omi 
both keys default to 0. 


Functional Details: 


If the file to be deleted by the XALLOCATE command does 
exist, no error will occur. A file can be deleted 
reallocated only if it is not currently assigned to a task, 
its write and read protection keys are 0 (X'0090"). 


Example: 
XAL PROG1.TSK,IN, 89 
Messages: 


ALLO-ERR 


indicates that the allocation failed for reasons denote 
TYPE field. ‘ 


DELE-ERR 


indicates an error occurred while trying to delete a 
Types of delete errors follow. 
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byte, 
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not 
and 
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d by 


file. 


0 ROOD 


FD-ERR 
indicates that an invalid fd is specified. 
NODA-ERR 


indicates that direct access suppart was not includad in the 
system at sysgen. 


NOPR-ERR 
indicates that a required operand is missing. 
PARM-ERR 


indicates that an operand syntax error occurred. 
DELE error TYPE field responses: 


PRIV 

indicates that the file is currently assigned to a task. 
PROT 

indicates that the read/write protection keys are not zero. 
VOL | | 


indicates that the specified volume is not mounted. 


48-030 FOO ROO 3-137 


oe ee oe Oe Be ee oe om ee 


me ee ee oe ee ee ee ee oe oe oe 


3-57 XDELETE COMMAND 
The XDELETE command is used to delete one or more files. If the 
Kile does not exist, no error is generated. 
Format: 
XDELETE fd, [-£4, +++, 8d, 
Parameter: 


td is the file descriptor to be deleted. 


Functional Details: 


fold 


A file can be deleted only if it is not currently assigned to 
task and its write and read protection keys are 0 (X'°0000°). 


Examples: 
XDEL FIXD:0$8S323240.817,EADPROC.FIN 
Messages: 


DELE-ERR 

indicates that delste failed for reason Hevea Bi LIYPE field. 
FD-ERR 

indicates an invalid f4. 
NODA-ERR 


indicates that direct access support was not included in th 
operating system. 


NOPR-ERR 


indicates that no ogperand is specified. 
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DELE error TYPE field responses: 


PRIV 

indicates that file is currently assigned to a task. 
PROT 

indicates that read/write protection keys are not 0. 
“VOL 


indicates that specified volume is not mounted, not online, 
or does not exist. 


48-030 FOO ROO - 3~139 


CHAPTER 4 
SYSTEM ERROR HANDLING 


%.1 ERROR TYPES 

There are three kinds of system level error conditions that can 
occur during operation of OS/32: 

® kKecoverable errors 

® Abnormal task termination 


® System failures 


A recoverable error occurs when the system detects a condition 


that reguires operator intervention in order to continue. In’ 


this case, the system prints a message describing the condition 
(e.g-e-, PARM-ERR). The operator can then issue a commani to 
correct the error. See Chapter 3 for the messages output by 
OS/32 while processing operator commands. 


An abnormal task termination occurs when a malfunction is 
detected during execution of a user task, and the system cannot 
continue executing the task without destroying the system or user 
informations. At this point, the system prints a message that 
describes the error detected (e.g., ILLEGAL INSTRUCTION, ILLEGAL 
SVC), and the location of the instruction causing the error. The 
user task is then pausei. The operator can correct the error 
condition and use the CONTINUE command to proceed, or the task 
can be aborted with a CANCEL command. 


A systen failure occurs when a hardware or software malfunction 
is detected during execution of system code, and the system 
cannot proceed without running the risk of destroying 
information, either on some peripheral device or in mamory. At 
this point, the system displays a crash code on the display panel 
and the system console. It also displays on the system console 
a program status word (PSH) status and location of the crash 
condition. It then stops. System crash codes are given in 
Appendix D. 
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4.2 SYSTEM FAILURE RECOVERY. 


The systen failure handler is designed to mininize destruction of 
user data when a failure occurs and to facilitate system 
debuyging. The following steps must be acconplished to retrieve 
the information needed to determine the cause of the failure. 
Steps 3 and WY must be accomplished whenever any failure occurs. 


1. Kecord the system failure code, the contents of the system 
journal, and the seygquence of the operator tommands leading to 
the failure. This information can ba obtained as follows: 


- Failure code - This code is displayei on the console 
display vanel and is also stored in location SPT.CRSH in 
the system pointer table (SPT). System crash codes are 
Summarized in Appendix D. 


- Svstem journal ~ Register 5 (of register set 0) contains 
a pointer to the system journal. Register 6 contains a 
pointer to the last entry in the system journal. 


- Operator commani - If the console is a Viieo Display Unit 
(VDU). device, note the information remaining on the 
screen. If the console is a hard copy ievice or LOG was 
set to a hard copy device, all information loyged since 
the last operating system initialization should be 
preserved. 


2% When possible, obtain a panic dump. Refer to Section 4.6. 


3. Reload the operating system. Do not restart at location 
K°69" 6 


4. If any direct access devices were marked online at the tine 
of the failure, run the 95/32 Disc Integrity Check Utility. 
See the 05/32 Systam Support Utilities Reference Manual. 

5. To interpret the information produced by step 2, run the 
OS/32 Dump Print Utility. See the 05/32 System Support 
Utilities Reference Manual. 

H.2.1 Submitting Problems for Investigation 

When submitting this information to Perkin-flmer, please include 

the following information: 

@ FSW and LOC at time of failure 


® Panic dump tape 


> Configuration statements and library Loader map of systen 
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e Console log prior to failure 
'@ Time of failure 
@ Description of the failure including any system messages 


® Conditions surrounding the failure 


4.3 POWER FAIL/RESTORE 


When a power fail is detected by the precessor, an interrupt 
occurs and OS/32 saves the registers and prepares itself for 
another interrupt when power is restored. The following message 
appears on the console when powar iS restored: 


POWER RESTORE - RESET PERIPHERALS AND ENTER GO 


After the message is printed, operator intervention may be 
reguired to reset any devices that might be in an offline or 


write-protected state as a result of the power failure. The 
operator intervention requirement is a source system generation 
(sysgen) option. If operator intervention is required, the 


operator can. continue the power restoration process by antering.. 


GO followed by a carriage return on the system console. 


Upon completion of the power restoration process, the following 
message is output to the system console: 


POWER FAILURE AT mm:dd:yy hh:mm:ss 


The date and time are displayed in the format specified at sysgen 
time. All nondirect access I/0 operations in progress at the 
time the power failed are aborted, and an error status is 
returned to the task. Direct access I/O operations ar2 retried 
when power is restored. 


The power restcration module schedules power restoration traps 
for those tasks that require such knowledge and have the power 
restoration trap enable bit set in the current task status word 


(TSW). When there is a power outage, a TSW swap occurs when 
power is restored, and all tasks with the power restoration trap 
bit enabled enter the user-defined power restoration trap 


routine. All other tasks are paused with the message: 
taskid:TASK PAUSED 


Rerer to the OS/32 System Planning and Configuration Guide for 
information oon eliminating operator intervention requirements. 
Refer to the OS/32 Application Level Programmer Reference Manual 
for further information on power fail/restoration traps. 
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4.3.1 Shared Memory Power Failure 
When a power failure occurs in a shared memory cabinet, tl 


following message is displayed on the system console of ea 
system utilizing shareil memory: 


SHARED MEMORY POWER FAILURE AT hhimm:sss,mm:iddsyy 

The time and date are displayed in the format selected at sysg 
time. 

Tasks that attempt to read an area of shared memory will recei 
the following error message and will be paused: 


NONCONFIGURED MEMORY 


eu DISK I/O ERRORS 
Certain disk-related I/0 errors and bit map errors indicate th 
the integrity of the disk volume is in doubt. When possib] 
OS/32 warns the operator of disk-related errors by issuing t 
following messages: . 

RIT MAP ERROR ON voln: MARK OFF AND CHECK 

T/O ERROR ON voln: MARK OFF AND CHECK 
In the event of these errors, the operator should mark of f1: 
the disk volume as soon as possible and execute the D 
Integrity Check Utility. . 
4.4.1 Secondary Directory Overflow Error 
When the secondary directory becomes full, the operator 
infcrmed by the following nessage: 


CDIP FULL - devn 


The device mnemonic of the disc is devn. 


Refer to the MARK command description in Chapter 3 for  furt 
information and action necessary in this situation. 
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8.5 SYSTEM SHUTDOWN AND RESTART 

In disk-oriented OS/32 systems, it is necessary that the system 
be shut down or restarted in an orderly fashion to #2nsure the 
integrity of the disk volumes in use. In particular, before 
shutting down or restarting OS/32, the operator should: 


®@® cancel and delete (nake nonresident) all tasks, and 


® mark all disk devices offline. 


08/32 now can be restarted at location X'60°. 


If the system is reloaded as a result of a system failure, the 
Disk Integrity Check Utility shonld be used to restore the 
integrity of the data on all disk volumes online at the time of 
the failure. 


NOTE 

If a system fails, it must not be 

restarted at X°60°. It must be reloaded 

to ensure system integrity. 
4.6 OS/32 PANIC DUMP PROGRAM (STAND-ALONE SYSTEM DUMP) 
The panic dump program allows the user to copy the entire 
contents of memory to a user-specified magnetic tape or disk 
device. Panic dumps should be performed immediately following a 
system failure due to a malfunction in: 
® hardware, 
e system software, 
® a user-written driver, or 
®@ areas in the operating system modified by the user. 
After a panic dump has been performed, the contents of the dump- 
should be listed to a print device using the Dump Print Utility. 


Refer to OS/32 Systems Supovort Utilities Reference Manual for 
instructions regarding the use of the Dump Print Utility. 
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4.6.1 Electing to Perforn a Panic Dump 


The user has the option to perform a panic dump whenever a systen 
failure occurs. The following message is displayed immediate/ 
below the system crash code and status information display: 


DO YOU WISH A SYSTEM DUMP? CY/N) 


If a panic dump is not desired, enter N (no) which causes) thi 
system to halt. Manual recovery must then be performed using thi 
procedure outlined in Section 4.2.2 If a panic dump is desired 
enter Y (yes) which causes the following progran id message to bi 
displayed on the system console: 


OS/32 SYSTEM DUMP Rnn-uu 


nn is a decimal number indicating the revisio 
level, and . 


vu is a decimal number indicating the updat 
' level . . 


Immediately following the program id, a menu containing the name 
of the magnetic tape and disk devices with standar 
configurations supported by the panic dump program is display 

as follows: . . ; 


DEVS 
MG85 
MGC5 
KG52 
DS67 |. 
C138 
OTHR 


The default configurations for each device in the menu ar 
presented in Table 4-1. 
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TRBLE t-1 PANIC DUMP PROGRAM SUPPORTED DEVICES WITH 
STANDARD CONFIGURATIONS 
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Renovable 
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DFVICE | DEVICE | DEVICE | DEVICE | CONTROLLER | SELCH 
NAME | DESCRIPTION {| CODE | ADDRESS | ADDRESS | ADDRESS 
MG8"% | $800 83PI Mag tape 1 40 | 85 | N/A t FO 
| a | | I | 
MSC5 | 1500 3PI Mag tape { 41 } ¢5 | N/A { FO 
| | | | | 
MG62 | 6250 BPI Mag tape } 4u | 85 | N/A | FO 
{ | | } { 
| , | | | 
D367 | 674%b Disk } 35 | FC | FB 1 9 
| | | | | 
C13R | 13.5¢b Disk - CMD } 38 | FC | FB 1 FO 
| i | | | 


The following prompt is displayed immediately following the | 
device menu: ] 


LDEVICE=ddda . 


ddd4 is a 4-character string indicating one of the 
supported devices Listed in the device menu. 
Standard configurations for these supported 
devices are automatically represented in the 
system as listed in Table 4-1. If a unique 
configuration is desired for a device listed 
in the menu, enter OTHR. The type of device 
entered ia response to the DEVICE= prompt 
determines which of the following three pronpt 
sequences is issued. 
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when a device is specified, the panic dump 
program compares the amount of free space 
availahle on the device to the size of memoary 
to be dumped. If there is insuffitient free 
space on the device to hold the entire memory 
dump, the following massage is displayed: 


DUMP WILL NOT FIT | 


The panic dump program ‘then returns to the {f 
DEVICE= prompt to allow the user to select a | 
new device. | 
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DUMP 


Mag Tape Device 


If a nagnetic tape device with a standard 
configuration is specified in response to 
the DEVICE= prompt, the panic dump program 


begins execution. Memory contents are 
written to tape in 2kb records. When the 
dump is successfully completad, this 
message is displayel on the systen 


console: 
SYSTEM DUMP COMPLETE 


The tape is immediately rewound, registers 
are restored and the machine is halted. 
At this point a manual recovery from the 
systen failure should be performed. See 
Section 4.2. If the tape does not rewind 
the dump was not successful. Ensure that 
the tape drive is funstional, write ring 
inserted, heads are clean, and then 
restart the procedure. 


Disk Device 


If a disk device with a standard 
configuration is specified in response to 
the DEVICE= prompt, the following message 
is displayed: 


~VOLUME=DUMP,FILE=filename.ext 


is the name Gf the vcGlume to whith menory 
contents are to be dumped. If the raquested 
disk device has a valid volume mounted 
with a name other than DUMP or whose 
directory structure is not consistent with 
the panic dump fornat the following 
message is displayed: 


VOL xxxx IS TO BE OVERWRITTEN (Y/N) 


If Y¥ (yes) is entered, the panic dumo 
program generates a new volume descriptor 
and directory. Ensure that ther# are no 
files that are required for future use on 
the volume to be overwritten. Panic dunp 
could overwrite these files ani the iata 


Wiil not be accessible in any case. 
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filename. 
ext 


DEV #=aaa 


aaa 


DEV CODE=cc 


ce 


CTLR ADDR=nnn 


nnn 


SLCH ADDR=sss 


sss 
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If N (no) is entered, the panic dump 
program wili return to the DEVICE= prompt. 
This allows the user to specify 3 
different device or change the disk pack. 


is a 1- to 8-character filenane, followed 
by a 1~ to 3-character extension for the 
file that will hold the memory dump 
contents. The panic dump program 
automatically assigns the specified file 
to account 0. After the fd is entered, 


the panic dump program begins execution. 


Other | 


A response of OTHR to the DEVICE= prompt — 


allows the user to specify a non~staniard 
device configuration for a supported 
device. The following prompt sequence is 
displayed on the system console: 


isa 1- to 3-digit hexadecimal number 
indicating the address of the device to 
which the dump contents are to be Sent. 


is a 2-digit hexadecimal number indicating 
the code of the device to which the dump 
contents are to be sent. The device codes 
listed in Table 4-1 are the only valid 
device codes. The device code entered 
here identifies the type of device to 
which the dump contents are being written. 
The next prompt in the sequence is 
dependant upon the type of device 
indicated by the device code entry. 


isa 1- to 3-digit hexadecimal number 
indicating the controller address for the 
device indicated by the device code. This 
prompt is not displayed if the device is 
a magnetic tape device. 


isa i- to B-digit hexadecimal number 
indicating the SELCH address. 


map © wom eee SE eee eee eee eee ee 


oes eee ores ee Oe 


we ee eome come 


4.6.2 Disk Utilization 


A single disk can hold no more than five panic dumps, depending 
upon the size of the disk and the size of memory to be dumped./( 
Tf a disk directory already contains five dump entries and a 
sixth is attempted, the following message.is displayed: 


VOL xxx IS TO BE OVERWRITTEN (Y/N)? 


Tf the panic dump program determines that there is not enough 
disk space to hold an entire memory dump, the following message 
is displayed on the system console before the dump begins: 


DUMP WILL NOT FIT 
VOL xxx IS TO BE OVERWRITTEN (Y/N)? 


If Y (yes) is entered, the panic dump program generates 2 new 
volume descriptor and directory. Tf N (no) is entered, the 
program returns to the DEVICE= prompt to allow the user to 


specify a different device or change the disk pack. 


If Y¥ Cyes) is entered, the panic dump program reinitializes the 


disk specified as the storage disk and exetutes. Data on the 
disk will be overwritten. Therefore, before entering Y (yes) as 
a response to this prompt, ensure that there is no data ta be'- 
saved for future use on the disk. Once the panic dump has been 
completed, the user can access the dump file under OS by marking 
the disk on, via the MARK ON PROTECT command, and then assigning 
the dump file, via the ASSIGN command. A panic dump cannot be 
accessed unless the disk has been run through DISCHECK or is 
marked on , protected. In order to delete a dump file, the user 
must first run the DISCHECK utility on the disk to rebuild the 
bit map. The panic dump routine can be restarted at X °70° 
following an error condition. 


4.6.3 Examples of Panic Dump Device Specification 
The following are examples of the panic dump prompt sequence for 


various devices. Underlining indicates user. supplied 
information. 


@ Writing the contents of a panic dump to a 800 BPI magnetic 
tape with a standard configuration: 
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DO YOU WISH A SYSTEM DUMP (Y/N)? ¥ 
OS/32 SYSTEM DUMP RO6-00 

DEVS 
NG85 
MCCS 
NS62 
DS67 
C13R 
OTHR 
DEVICE 


i} 
[= 
IG 
{co 
jn 


SYSTEM DUMP COMPLETE 


© Writing the contents of a panic dump to a CDD removable disk 
with a standard configuration: 


DC YOU WISH A SYSTEM DUMP (Y/N)? X 
OS/32 SYSTEM DUMP RO6-00 

DEVS 
MG85 
HGC5 
MG62 
DS67 
213K 
OTHR 
DEVICE 


i 

IQ 
| 
Jy 
es) 


VOLUME 


Il 

= 
rom) 
x 
rod 
« 

rey 
ri 
rc 
3) 

MI 

oO 
es} 
4 
to 
cS 
SG 
N3 
[e.9) 
e 

© 
oO 
ab 


ne eet nee ee a te et oe ee oy 


SYSTEM DUMP COMPLETE 


® Writing the contents of a panic dump to a 800 BPI magnetic 
tape device with a nonstandard configuration: 


DO YOU WISH A SYSTEM DUMP (Y/N)? Y 
OS/32 SYSTEM DUMP RO5-00 

DEVS 

“G85 

MGC5 

MG62 

DS67 

C13R 

OTHR 

DEVICE = OTHR 

DEV # = 85 

DEV CODE = 
SLCH ADDR = 


SYSTEM DUMP COMPLETE 
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e Writing the contents of a panic dump to a 67MNb fixed disk with 


a nonstandard configuration: 


DO YOU WISH A SYSTEM DUMP (1/8)? 4 
0S/32 SYSTEM DUMP RO6~-00 

DEVS 

MG8S 

MGC5 

NG62 

DS67 

C13R 

OTHR 
DEVICE = 
DEV #H=E 
DEY CODE = 3 
CTRL ADDR 
SLCH ADDR 
VOLUME=DU MP, FILE=DUMP0928.001 


Wo 
Pa lotion 
[=> iro 


SYSTEM DUMP COMPLETE 
8.6.4 Panic Dump Messages 


ERRORK.«.«-FILENAME EXISTS ON DUMP DISC 


The filename entered by the user for the dump 


exists on the specified disk. 
TOERROR DU STATUS=XX 


The user-specified device is unavailable. 


file already > 


XX is the 


hexadecimal hardware status sent from the device. Refer to 


the device's appropriate hardware manual for 
of the status setting. 


ITOERROR® CNFG STATUS=XxX 


an explanation 


An I/0 error occured because the hardware sonfiguration does 
not correspond with that specified by the user. XX is the 
hexadecimal hardware status sent from the device. Refer to 
the device’s appropriate hardware manual for an explanation 


of the status setting. 


LTOFRROR UNRE STATUS=XX 


An unrecoverable T/0 error has occurred. 


XX is the 


hexadecimal hardware status sent from the device. Refer to 


the device’s appropriate hardware manual for 
of the status setting. 


an explanation 
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CHAPTER 5 
THE COMHAND SUBSTITUTION SYSTEM (CSS) 


5-1 INTRODUCTION 


The OS/32 CSS is a versatile command language that can be used to 
control anything from a single batch stream to complex macro 
commands. CSS has many of the characteristics of a programming 
language. Its structure, however, allows Simple functions to be 
performed without complete familiarity with CSS. This chapter is 
intended as a guide for the user, from the beginning stages 
through the more advanced stages of CSS use. [t is assumed that 
the user is familiar with the functions of the OS/32 operator 
commands, or at least with their most common forms, described in 
Chapter 3 of this manual. While CSS is active, the system 
console remains available for operator commands and task I/O. 


5e2 CSS FILES 


A CSS file is a series of OS/32 operator commands. Every 
operator command can be executed from a CSS File. In addition, 
a number of special CSS commands can be executed. The special 


CSS commands (except SET CODE) begin with a dollar sign, making 
them easy to identify. The series of operator commands contained 
in a CSS file exists on media such as cards, disc, or magnetic 
tape. When the CSS file is called, the commands contained within 
the file ara executed in order. When the special CSS commana 
SEXIT is executed, CSS execution is stoopeil and control is 
returned to the caller. CSS files can be called by the operator 
or other CSS files. . 


If the CSS procedure is to be contained in a disk file, the CSS 
filename specified must be different from all standard operator 
commands and mnemonics, including any abbreviations. Thus, thesa 
are valid CSS filenames: : 

ABC.CSS 

XYZ4C€SS 


AB.CSS 


Vl 
! 
=" 
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However, these CSS filenames are not valid: 


AL.CSS | AL is an abbreviation for the ALLOCAT 
command. 
RW-.CSS 7 RW is an abbreviation for the REWIND command. 
P1.CSS P is an abbreviation for the PAUSE command 
| Mnemonic scan stops at the first nonalphabeti 
character. | be 8 


These filenames can be made valid by prefixing the call to CS 
with a volume name. For example: ey 


M300:AL 
M301:RY 
MIM:P1 


They can also be made valid by explicitly specifying the fils 
extensions. For example: 


AL.CSS 
RW.CSS 
P1.CSS 


5.2.1 Calling CSS Files 


The CSS file is placed in a source input device, @eGe, A CAarc 
reader, magnetic tape, etc. The device being used must be 
online. CSS files may also exist as direct access files.'§ Tc 
call the CSS file, the operator enters the name of the device or 
disk file in the same way as a command is entered. For example, 
if the file is on cards, and the card reader is named CARD , the 
Operator enters the following and the card file is executed: 


CARD: 


522-2 One CSS File Calling Another 


To OS/32, a CSS file is the same as the system operator. 
Therefore, one CSS file can call another. However, when too many 
CSS files are active, the command processor buffers may fill and 
a new CSS file cannot be called. The maximum nesting depth is 
set at sysgen. If one CSS file tries to call another, exceeding 
the designated depth, the system produces the following error 
message and CSS processing ceases: 
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SS SS TY 


When one CSS file calls another, the first file is still active. 
When the second file finishes processing, exertution continues in 
the first CSS file at the command following the call to the 
second CSS file. 


5.3: USING CSS FOR BATCH CONTROL. 

CSS can be used to control a batch job. This allows the user to 
prepare a sequence of operator commands and the iata for the job, 
and then to enter the entire job stream to OS/32 through CSS. 
5.3.1 Job Control Decks 


. The following job control deck illustrates the use of CSS to 
| control a batch job from the card reader (CR:): 


LOAD .BG,CAL32.TSK Load assembler from file 
/ CAL32.T5SK 
TASK .w«BG 
ASSIGN 1,CR: Assign source input to this 
file 


ASSIGN 2,MAG1: 

ASSIGN 3,PR: 

TEMPFILE 4,1IN,86 

START ,TARGT=32,SCRAT Start assembler 


- (source progran) 


REWIND MAG1: 

RUILD LNK.CHD 

MAP PR:,ADDR,-ALPH,XREF 
INCL MAG7: 


BUILD PROG.TSK . Load module is now built 
END 

ENDB 

LOAD .~BG,LINK Load Link 

TASK .BG 

START ,CON=LNK.CKD, L=CON: Start Link 

LOAD .~BG,PROG.TSK Load new module 

TASK .BG 

START Run progran 

SEYIT End job 


The first statements load the CAL32 assembler, assign devices and 
* files to their logical units, and start the assembly process. 
Following these Statements ,are the source statements of the 
program to be assembled. Next are the command statements to load 
Link. The START command begins execution of Link. It is 
followed by a series of Link commands, terminated by the Link END 
conmand. The Link commands are followed by a LOAD command that 
loads the module Link produced and runs the program. Finally, 


© 


the SeXIT command returns control to the operator. 
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5.3.2 Separation of Jobs 


When any error occurs in processing a CSS file, CSS processing 
stops, and control is returned to the system console. This may 
be desirable in some cases, but not when batch jobs are being 
run. If there are several sets of job control statements in the 
CSS file (for example, in the card reader), the faulty 
termination of one job must not cause all jobs to be aborted. 
The CSS commands $JOB and STERHJOB are used to isolate the 
effects of errors to a single job. Each job control deck may 
start with a SJOB statement and end with a STERNJOB statament. 
Then, if an error in a given job is detected, the CSS processor 
skips all commands until a STERMJOB is found, and resumes normal 
CSS processing. 


A typical batch deck, consisting of several jobs, might look like 
thiss 


$JOB - Start of first job 


- (first job control deck) 
STERMJOB End of first job 


SJGB 


‘ (second job control deck) 
STERMJOB ; End of seconi job 


SJOB 


‘ (further job control decks) 


STERMJO3 
SEXIT End of batch stream 


NOTE 


It is not permissibie to nest jobs. 


5.3.3 Program Pauses and Other Interactions 


It is not good practice to let CSS processing continue while a 
program called by CSS is running. In any job control deck, the 
job steps are sequential. When a program is started, it should 
run to completion before ‘more CSS statements are executed. 
Otherwise, the CSS processor might try t2 perform device 
assignments for the second job step before the first one is 
finished. 
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When a background program executes a pause, CSS processing does 
not resume. Instead, the pause message is routed to the system 
console. The operator is responsible for correcting the error 
and issuing a CONTINUE command. As far as CS3 is concerned, the 
program is still active, whether or not it has paused. If the 
program goes to end of task or if it is cancelled by the 
Operator, CSS processing resumes. This procedure assumes that 
programs only pause due to an error or because some abnormal 
condition occurred and the program is unable to take corrective 
action by itself. Thus, operator intervention is required. 
Programs that pause arbitrarily or CAL assemblies with PAUSE or 
PPAUS statements in their source decks cannot be properly handled 
under CSS batch control. 


5.3-4 SPAUSE, SCONTINUE, and SWAIT Conmands 


The SPAUSE command suspends a CSS, allowing time for the operator 
to respond to an external event; i.ee-, mount a tape. The SPAYSE 
command is valid only from CSS and cannot be entered from the 
System console. If entered, the following message is displayed: 


PAUS-ERR 


The SCONTINUE command continues a CSS suspended by a S$PAUSE or 
SWAT? . The SWAIT command suspends a CSS for a specified period 
of time. It is valid only in CSS. If the user does not want to 
wait the specified period of time, the SCONTINUE command can be 
entered to continue the CSS. 


The formats for these commands are: 


The parameter n in the WAIT command is a decimal number from 1 to 
900 indicating the number of seconds that CSS is suspended. Tf 
the parameter is omitted, the default is 1 second. 


5e4 USING CSS TO AVOID REPETITIOUS ACTIONS 
CSS is not used for batch control only. It also can be used to 
avoid lengthy, repetitious operator instructions. Assume that at 


a given installation all CAL assemblies are done with a standard 
set of lu assignments. These assignments are made into a CSS 
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file, and that CSS file is put on disk and useil before each CA’ 
assembly. For example, assume a disk file named CALASIGN.CS 


contains the following commands: 


CLOSE 1,2,3,4,5,6,7,8 
XALLOCATE CALSCRAT.TMP,IN,80 
XALLOCATE CROSSREF.TMP,IN, 256 
XALLOCATE SYMDUMP.TMP,IN,256 
XALLOCATE SQUEEZ.TUP,IN,255 
XALLOCATE ERRLST.TMP,IN,80 
ASSIGN 1,CR: 

ASSIGN 2,MAG1: 

ASSIGN 3,PR: 

ASSIGN 4,CALSCRAT.THP 

ASSIGN 5,CROSSREF.TMP 

ASSIGN 5,SYMDUMP.TMP 

ASSIGN 7,SORCELIB.CAL 

ASSIGN 8,SQUEEZE.TMP 

ASSIGN 9,ERRLST.TMP 

SEXIT 


The operator places the source in the card reader device (CR:) 
places an output tape on the magnetic tape device (MAG1:), types 


LOAD «BG,CAL32 
TA 2BG 

CALASIGN | 

START ,SCRAT,CROSS,ERLST 


and the assembly proceeds. The LOAD and START commands also ca 
be put on the CSS file. This procedure reduces operato 
intervention and the possibility of error. 


CSS can be used to enter patch information to OS/32 aftar syste 
startup. If an installation has a. list of patches to be entered 
the patches are prepared on a card deck, with verificatio 
information, as follows: 


BIAS 9 

KODIFY 7FEO,220,80A,4300,1ED4 
EXAMINE 1FEO,48 

SEXIT 


tinmediately upon system startup, this deck is put-in the cart 
reader, and the command CR: is entered from the console. Th 
CSS file is then read, and the patches are made to the syste 
without the problem of typing errors. The EXAMINE comman 
displays the contents of the patch area following th 
modification. 
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5.5 USING CSS TO BUILD COMPLEX COMMANDS 


CSS also is used as a system macro command language to build 
complex commands. The basic set of commands provided in the 
command processor is sufficient to perform any function, but may 
require operator interaction. 


5.5.1 Passing. Arguments to CSS Files 


The CAL assignment example given in Section 5.4 does not work if 
some of the devices vary from assembly to assembly. When 
executed, file CALASIGN always assigns lu 1 to CR:, lu 2 to 
MAG1:, etc. 


To make asSignments more flexible, it is necessary to pass 
arguments to a CSS file. This is accomplished by using the 
character sequence @n. Whenever the sequence dn (where n is an 
integer greater than or equal to 0) is detectei in a CSS commana, 
the CSS processor -uses the n argument in the C3S calling 
statement. For example, assume that CSS file ASINE123.CSS 
contains the following commands: 


ASSIGN 1,01 

ASSIGN 2, a2 

ASSIGN 3,903 | ° 
SEXIT 


and the operator types: 
ASINE123 CR:,/MAG1:,PR: 
The CSS file is executed as though it contains: 


ASSIGN 1,CR: 
ASSIGN 2,MAG1: 
ASSIGN 3,PR: 
SEXIT 
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The first argument of the calling statement is CR, and every 
occurrence of the sequence a1 in the CSS file is replaced with 
CR:.- An argument is always terminated with a comma or end of 
line. Therefore, the second argument is MNAG1:, and the third 
argument is PR:. In the previous example, CALASIGN can be turned 
into a generalized ASSEMBLE CSS as. follows: 


LOAD .BG,CAL32 

TASK .BG 

CLOSE 1,:27370,5067 78 
XALLOCATE CALSCRAT.TMP,IN,80 
XALLOCATE CROSSREF.TNP,IN,256 
XALLOCATE SYMNDUMP.TMP,IN,256 
XALLOCATE SQUEEZE.TMP,IN,256 
XALLOCATE ERRLST.TMP,IN,890 


ASSIGN 1,91 © **VARIABLE INPUT 
ASSIGN 2,22 >*VARIABLE OUTPUT 
ASSIGN 3,03 **VARTABLE LISTING 


ASSIGN 4,CALSCRAT.TMP 

ASSIGN 5,CROSSREF.TMP 

ASSIGN 6,SYMDUMP.TNP 

ASSIGN 7,04 *>*VARLABLE SOURCE LIBRARY 
ASSIGN 8,SQUEEZE.TMP 
ASSIGN 9,ERRLST.THMP 

START ,SCRAT,CROSS, ERLST 

SEXLE 


This file can be called as follows: 


ASSEMBLE CR:,MAG1:,PR:,SORCELIB.CAL 


The first argument is the input device; the second, the output 
device; the third, the listing device; and the fourth, the source 
Library. devices 


6-5-2 Device Independent Job Control Decks 


The example in Section 5.5.1 assumes that the CSS file is from a 
device name. It would not work properly if the device were 
changed to MAG2: Since the CSS statements sperzifically assign lu 
1 of CAL32 to a device name CR:. To create a device independent 
job control deck, use the characters @0 whenever referring to the 
CSS file itself. The characters 20 mean "this device or file". 
The ASINE123 example must be changed as follows: 


LOAD .~BG,CAL32 
‘TASK .BG 
ASSIGN 1,20 
ASSIGN 2,NAG1: 
ASSIGN 3,P&: 
SEXIT 
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To start the CSS job stream, issue this from the system console: 


CR: 
Logical unit 1 is assigned to CR:. 


5.5.3 Testing Arguments for Existence 


Assume that the operator wants to assemble the previous program 
without using a source library device. 


Example: 
ASSEMBLE C2:,MAG4:, PR: 


The fourth argument is missing. A missing argument is considered 
to be a null string, that is, a sequence of no characters. 
Therefore, the command ASSIGN 7,04 is executed as: 


ASSIGN 7, 


This is an illegal command, and the CSS £ile aborts. 


It is possible to test whether or not an argument exists. This 
is done with one of the special CSS commands, 3IFNULL or 
SIFNNULL. The SLFNULL command tests to see whather an argument 
does not exist. The SITFNNULL command tests to see whether an 
argument does exist. If the tested condition is true, the C5S 
processor continues to execute statements until a SELSE is found. 
At that time, the CSS processor skips until the corresponding 
special command S$ENDC (end conditional) is found. If a SELSE is 
not present before the corresponding SENDC, the CSS processor 
continues to execute statements. If the tested. condition is not 
true, the CSS processor skips all statements until command SELSE 
is found, at which time the CSS processor continues t9 execute 
statements. If a SELSE is not present before the corresponding 
SENDC, statement execution resumes after the SENDC. Therefore, 
the command: 


ASSIGN 7,04 


can.be replaced with the following: 


SIFNNULL a4 Is there a source library? 
ASSIGN 7,a4 If so, assign it to lu 7 

SELSE If not, 

ASSIGN 7,NULL: assign lu 7 to the null device 
SENDC End of conditional 


w 
{ 
wo 
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If, when skipping, the C3S processor attempts to skip beyond a 
STERMJOB or end of file (EOF), an error occurs. Jse of the 
multiple @ notation is permitted to test for the existence of 
higher level parameters. A combination of parameters can be 
tested simultaneously. For example: 


SIFNULL a1 02 03 
This tests the logical AND of a1, 22, and 93 for null. If any of 
the three are present, the test results ina false condition. 
CSS also can be used to set up default assignments. For example, 


assume the list device is normally thea printer (PR:). The 
following sequence is put into the ASSEMBLE.CS5 file: 


SIFNULL 023 Is there a list device 
specified? 

ASSIGN 3,PR: If not, use PR: 

SELSE If there is, 

ASSIGN 3,43. assign it to lu 3 

SENDC 


If the operator then enters: 
ASSEMBLE MAG2:,MAG3:,,MAG4; 


argument 3 is null; therefore, the listing is assigned to the 
printer (PR:). ; 


5.5.4 Testing Files for Existence 


It is often desirable to allocate files from a CSS file. Assume 
the ASSEMBLE.CSS file previously developed requires a number of 
scratch files. Then: 


® if the scratch file already exists, it is an error to. try to 
reallocate it, and the CSS file aborts; or 


® if the file is not allocated and it does not exist, the ASSIGN 
command is in error, and the CSS file aborts. . 


To solve this problem, a facility is provided to allow the CSS 
file to test the existence of certain files. This is done with 
the SIFX (if file exists) and SIFNX (if file does not exist) 
commands. These special commands work in the same way as thea 
SIFNULL and SIFNNULL commands. That is, if the tested condition 
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is true, CSS commands are executed up to the corresponding SELSE 
or SENDC. If the test proves false, subsequent commands are 
skipped up to the corresponding SELSE or SENDC. If the program 
skips beyond a STERMJOB, an EOF error occurs. For example: 


SIFNX CALSCRAT.IMP Does CALSCRAT.TMP exist? 
ALLOCATE CALSCRAT.IMP,IN,80 No, allocate it 
SENDC End of conditional 


This sequence checks to see if the temporary file already exists 
and allocates it if it does not exist. 


CSS can be used to test for the existence of a file passed to the 
CSS file as an argument. For example, consider this CS3 file: 


LOAD .~BG,TASK1 Load a task named TASK1 

TASK «BG | 

SIFNX 21 If the file does not axist, 
ASSIGN 1,TTY: input source from ITY: 
SELSE If the file does exist, 
ASSIGN 1,01 use it for input 

SENDC 

ALLOCATE T1.TMP-,IN,80 Allocate an output file 
ASSIGN 2,T1.-TMP,ERW Assign for exclusive read-write 
ASSIGN 5,TTY: ‘ Assign command input to TTY: 

START Start the editor 

SIFX 21 If the TTY was not used, 
RENAME 01,T1.OLD rename the input file 

RENAME T1.TMP,01 Rename the output file 
SENDC 

SEXIT Return to the console 


If argument1 is the name of an existing file, that file is 
processed. The output file is named T1.TMP, but after execution 
is completed, the output file is given the name of the input 
file, and the input file is srenaned 11-9LD. If argument 
specifies a file that does not exist yet, the input device is 
assumed to be the TTY. The RENAME command is not applicable to 
nondirect access devices. 
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5.25.5 Multi-Level Parameter Passing 


In a CSS file that is called by other CSS files, and not by the 
system operator, it is possible to refer to parameters passed in 
both the current CSS file and its caller. This is done by using 
more than one @ sign to indicate the parameter number. For 


example: 


a1 is the first parameter passed to the current 
file. . 
aay is the fourth parameter passed to the caller 


of the current file. 


aaal is the seventh parameter passed to the 
_ caller's caller. 


If the number of @ signs exceeds the current nesting level, the 
null string is returned. This can be tested for by using the 
SIFNULL command. The multiple a Sign convention also can bea used 
with the special code 90. The 90 Sign refers to the identifier 
of the current file, @90 refers to the identifier of the caller 
of the current file, and @200 tefers to the caller’s caller, etc. 
These three constructs are discussed above. 


5.5.6 Making Files Caller Independent 


The previous example works properly only if the console device is 
called TTY: and if the CSS procedure is callei from the conssle 
device. It can be modified to work with any caller. It is 
desirable to be able to call a CSS procedure from a Job control 
deck or from a console device. 


A file can be made caller independent by replacing references to 
the caller with the character sequence 20), referring to the 
filename of the caller. Therefore, the changes to the abov23 
procedure are: . 


e 


STFNX 21 Ii the file does not exist, 
ASSIGN 1,900 input from the caller 
ASSIGN 5,420 Assign command input to caller 
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5.5.7 End of Task Codes and Error Handling 


When a program called by CSS detects an error and abnormally 
terminates, CSS should take special action. In a job control 
deck that performs a compilation, assembly, creation of a load 
module, loading, and execution of a program, it is useless to 


continue the process if the first step (the compilation) 
terminated in error. The CSS must be informed of the erroneous 
end of task. This is done through the end of task code. Each 


program, on terminating, returns an end of task code that can be 
used to show why the program terminated. This end of task csode 
is a number set up by the programmer in the SVC 3 call that 
terminates the program. For details on SVC 3, see the 0S/32 


Supervisor Call (SVC) Reference Manual. An end of task code of 


O means the program terminated properly with no errors. A 
nonzero end of task code means the program terminated abnormally. 
An end of task code of 255 means the task was cancelled by the 
system operator. 


CSS files can test the end of task code with a set of special CSS 
commands. These are: . 


SIFE vn Equal 

SIFG n Greater 
SIFL an Less 

SIFNE nn. Not equal 
SIFNG n Not greater 
SIFNL n Not less 


Examples of these commands are as follows: 


SIFE 74 Tf end of task code = 14 

SIFG O If end of task code > 0 

SiFL 255 If end of task code < 255 

SIFNE 1 . If end of task code # 1 

SIFNG 023 If end of task code ¢ the third 
argument | 

SIFNL 712840 If end of task coda > 12840 


If the tested condition is true, C3S continues t9 execute 
commands until a SELSE or SENDC is found. If the condition is 
false, CSS skips all statements until a SELSE or SENDC is’ found. 
In such skipping, attempts to skip beyond a STERMJOB or to EOF 
cause an error. ene 
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The special command SSKIP causes CSS to unconditionally skip to 
the next STERMJOB command, if it is inside a job control deck. 
This has the same effect as any error detected in a CSS 
statement. For example: 


LOAD .~BG,CAL32 Load the assembler 

TASK .BG 

START Start it 

SIFNE O Any errors? 

SSKIP If yes, skip further processing 
SENDC Otherwise, continue 


This is the simplest way to handle errors. Jf the program has 
multiple error end of task codes, each with a distinct meaning, 
the CSS file may inform the operator of the natura of the 
problem, as follows: 


LOAD .~BG,PROG Load the program 

TASK .BG i, 2 

START Start it 

SIFNE 0 If any errors 

SIFNE 1 RC=2 means fatal error 

SSKIP © So skip . 

SENDC ; But RC=1 means nonfatal error 

SCOPY 

*NONFATAL ERROR DETECTED 

SNOCOPY ; 

SENDC Continue after logging message 
Notice the nesting of the SIFNE...SENDC sequences. Nesting of 


any SIF tests is permitted, with no restrictions on nesting 
depth. 


A CSS file may test or set the end of task code. This is 
possible as CSS is active when the controlled program is 
inactive, and therefore, the end of task code is not used 
asynchronously. The end of task code is set using the command: 


SET CODE an 
which sets the end of task code to n, which is any number from 0 
Ehrough 255. 
The ability of CSS to set the end of task code may be used by one 
part of a CSS file to signal another, providing there are no 


programs started between setting and testing the end of task 
code. ; 
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5.5.8 Logging Messages to the Console 


The special CSS commands SCOPY and SNOCOPY or SWRITE allow the 
CSS file to log messages to the system console and the system log 
file, if present. Normally, CSS should be in SNOCOPY mode. 
Under these conditions, CSS commands are executed but are not 
printed on the console or on the log file. If the CSS command 
$SCOPY is executed, a copy of all CSS statements executsd up to 
and including the next SNOCOPY is printed at the console, on the 
log file, or both. The choice of routing is set up by the system 
console operator with the SET LOG command, and CSS must not 


attempt to override this choice. 


Since comments are printed, as well as commands, an easy way to 
log a message is: 


SCOPY 
*THIS IS A MESSAGE FOR THE OPERATOR 


SNOCOPY 
The easiest way to log a message is: 
SWRITE THIS IS A MESSAGE FOR THE OPERATOR 


5.6 CREATING CSS FILES ON DISK 


CSS files can be created on disk in one of two ways: . 


@® OS/32 Edit or OS/32 Source Updater Utility programs can be 
used. 


»® BUILD and ENDB commands can be used to create a CSS file 
directly from the system console. 


The BUILD command is used as follows: 
BUILD £filenane.ext 


This command causes an indexed file named filename.-ext to be 
allocated, With a logical record length equal to the buffer 
length determined at sysgen and with protection keys of zero. If 
the fd already exists, it is deleted and reallocated. The 
console enters into data entry mode so that data can be written 
to the allocated file. Every line typed at the console, f£rom 
that time until] an ENDS command is found, is written to the file 
being built. “oO paramater substitution is possible with the 
EUILD.«.-ENDB sequence.» This data may include any text, including 
conmandis, an sequences, etc. The command processor does not 
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attempt to execute any commands contained in the text, nor does 
it attempt to expand an sequences. The only item that cannot be 
written to a file being built is a line with the characters ENDB 
as the first command on the input line. When an ENDB command is 
read, the console reverts to its normal command mode. When the 
console is in the build data entry MOUS ¢ the prompt issued at the 


console is: 


~CMDP> 


To build a CSS file named FRED.CSS, this sequence is entered: 


BUILD FRED.CSS 

~C¥DP>*THIS IS A CSS FILE NAMED FRED 
~CXDPSSEXIT 

»CHDP>ENDB 


This CSS file is now eary for execution. Tt tan be called as 
follsaws: : 


FRED.CSS 
or 


FRED 


Since the CSS processor uses the default extension .CSS if the 
system operator does not enter an extension. The BUILD command 
also assumes the extension .CSS if the name specified does not 
include an extension. . 


A SBUILD...-SENDB sequence can be nested inside a BUILD...ENDB 
pair. . 


5.7 BUILDING TASK CONTROL FILES 


Although it is possible to embed task control commandS within a 
CSS file, certain problems can occur while using this technique. 
In this example the statements between START and SEXIT are not 
CSS commands but are commands to Link. 


LOAD .~BG,LINK ; Load Link 
TASK .BG 

START ,COMM=00,L=CON: 

INCL MAG1: 

BUILD PROG.TSK 

MAP PR:,XREF 

END 

SEXIT 


un 
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The START command activates Link which then reads from the 
beginning of the CSS file. An error occurs as Link tries to 
process the LOAD command. Link is ready to execute another Link 
command and does not recognize LOAD. 


To prevent these problems, the BUILD and ENDB commands can be 
used. For example: 


BUILD COMMAND.TMP Build command file 
INCL MAG1: : 
BUILD PROG.TSK Link's BUILD command 
MAP PR:,XREF 7 
END 
ENDB 
LOAD ~BG,LINK Load Link 
TASK .BG 
START ,COMM=COMMAND.TMP, L=CON: Start Link 
DFLETE COMMAND.TMP Delete command file 
SEXIT 

This sequence builds a separate task control file called 


COMMAND.TMP and assigns it to the Link command input lu. The 
control file is then deleted fron the disk before the CSS file 
terminates. 


The SBUILD and SENDB commands allow parameter substitution. If 
the specified fd does not already exist, it is created as it is 
with the BUILD command. The account number must be zero if 
specified. If the fd already exists, it is deleted and 
reallocated. . 


As with BUILD, no nesting of $BUILD is possible. A corrupt CSS 
file results if the attempt is made. S$BUILD and BUILD must 


appear last on the input line. SENDB and ENDB must be the first - 


commands on the input line. Commands following SEND3 and ENDB 
are executed. A BUILD..-e-ENDB sequence can be nested within a 
SBUILD.~.-SENDB paire 


Using the feature of parameter substitution, the following 
example shows how the fd MAG1: can be passed as a parameter from 
the caller. 


SBUILD COMMAND. THP Build command file 
INCL a1 

BUILD PROG.TSK Link's BUILD command 
MAP PR:,XKREF 

END 

SENDB 

LOAD .~.BG,LINK Load Link 

TASK BG 

START ,COMM=COMMAND.TMP,L=CON: Start Link 

DEL@GTE COMMAND.THP Delete command file 
SEXIT 


BRR-NAN FAN BAN 


[ 
| 
| 


Assuming the CSS file is named LNKBUILD.CSS, it could be invoked 
as follows: 


LNKBUILD MAG1: 


5.8 EXITING FROM CSS FILES 


These three commands are provided for exiting from CSS files: 
SEXIT, STPANSFER, and SCLEAR. SEXIT causes control to return to 
where it was when the CSS file was called. Control returns 
either to the console or toa higher CSS file. A SEXIT must 
terminate each CSS file called. SCLEAR causes control to return 
to the console, immediately terminating all CSS activity. The 
STRANSFER command causes the program to exit from the current CSS 
with all other levels closed and to enter into the new CSS. Thea 
formats of the commands are: 


SEXIT 
SCLEAR 
STRANSFER NEWCSS param, DALAM2,« eo 


5.9 USING STANDARD FILE EXTENSIONS 


In a disc-based system, standard file extensions can be used to 
save the system operator work and to allow CSS files to perforcn 
sophisticated functions. The concatenation facility of CSS 
allows the use of standard extensions. In an example of FORTRAN 
compilation, useful standard file extensions are: 


o FTN FORTRAN source 


CAL CAL source 
~ LST List file 
«ERR Error listing file 


A file COMPILE.CSS can be created to control compilation as 
follows: 


oS CONPTLE -CSS FILE 


LOAD .BG,FORTRAN Load the compiler 

ASSIGN 1,01.FTN Assign FORTRAN input 
ASSIGN 2,21.CAL,ERW Assign CAL output 

ASSIGN 3,021.LST,EWO Assign listing (appeni) 
ASSIGN 7,21 ERR Assign error message file 
START Start compiler 

SEE L And exit 
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This file is called as follows: 
COMPILE 


The COMPILE CSS procedure assumes the FORTRAN source is on a file 
called progname.FTN and puts the output, listing, and error 
messages onto files named progname.-CAL, progname.LST, and 
prognamseERR, respectively. This procedure also assumes that all 
the named files already exist. . . 


5.10 INTERACTION OF CSS WITH FOREGROUND/BACKGROUND SYSTEAS 


CSS is essentially a single-stream processor. Usually it is not 
possible to write a CSS file that can fully control a complex 
foreground/background system. Manual intervention by the system 
operator is often required to control such a system. Foreground 
systems are controlled, under normal circumstances, by intertask 
communication (SVC 6) calls between foreground tasks. The system 
Operator is required to intervene only in abnormal cases. [he 
background system, however, must be controlled fairly often by 
the operator, or by CSS files, if the backround is being run in 
a batch-like mode. 


The background segment is used by the operating system to control 
CSS execution. CSS is active only when the background task is 
dormant. While the background task is in any State other than 
dormant, CSS is inactive. Therefore, a START command in a CSS 
file should be the last command on the line if it is starting the 
background task. The System operator has full control over the 
system at these times. While the backround task is dormant, CSS 
is active if a CSS file was invoked. The state of foreground 
tasks has no effect on CSS activity. 


While CSS is active, the operator still can enter commands fron 
the system console. The execution of these commands may ba 
delayed while a CSS command is being read; however, this delay 
should not be excessive under normal circumstances. If the 
Operator invoked an interactive device such as TTY or video 
display unit (VBU) as a CSS file, the delay may become long. 
Therefore, CSS should not be invoked from such devices unless the 
operator is willing to relinquish a great measure of systen 
control. Tf a CSS file is active, any attempt to call another 
CSS file from the system console is rejected. 


CSS files may affect foregrcund tasks, but extreme care should be 
used, Since a task in the foreground, once initiated, is no 
longer under CSS control. ‘cSS use should be restricted to the 
-BG Segment. A TASK command read from a CSS file establishes the 
currently selected CSS task. Commands from the console ares not 
affected by TASK commands read from CSS, and CSS is not affected 
by TASK commands input via the console. All task related 
commanas (Chapter 3) and CSS end of task code testing encountered 
in a CSS file affect the currently selected CSS task. 
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When a CSS file is activated from the console, the curren 
selected CSS task is set equal to the currently Selezted ta. 
If the currently selected CSS task is deleted from thea systi 
any subsequent task-related or CSS end of task code test: 
commands are rejected with a task error (TASK-ERR). | . 


5-11 CSS COMMAND SUMMARY 


The following is. a summary of CSS commands and their meanings: 


BUILD £4 [, APPEND] 


constructs a CSS file without paramet 
substitution. 


END3 specifies end of BUILD. 
SET CODE n sets end of task code to n.. 
SBUILD constructs a CSS file with paramet 


substitution. 


SCLEAR returns control to console. 

SCONTINUE | continues a CSS file that was sussenaed by 
SPAUSE or SWATIT. 

SCOPY | produces a listing. 

SELSE reverses the effect of SIF until a SEN 
corresponding to SIF is encountered. 

SENDR specifies end of SBUILD. 

SENDC delimits conditionals described above. 

SEXIT specifies exit from CSS file. 

SIFE na specifies that if end of task code equals 1 


continue executing commanis; otherwise, ski 
to the corresponding SELSE or SENDC. 


SIFS n specifies that if end. of task code is greate 


than Nn, continue executing commands 
otherwise, skip t9 corresponding SELSE c 
SENDC. 

SIFL n specifies: that if end of task code is Iles 
than ny continue executing connands 
otherwise, skip to the corresponding SELSE 0o 
JEN « 
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SIFNE n 
SIFNG no 


SIFNL n 


SIFNX fd 


STRANSFER 


SWATT 


SHRITE 


48-0390 FOO &00 


specifies that if end of task code is not 
equal to mn, continue executing commands; 
otherwise, skip to the corresponding SELSE or 
SENDC. 


specifies that if end of task code is not 
greater than mn, continue executing commands; 
otherwise, skip to the corresponding SELSE or 
SENDC. 


specifies that if end of task code is not less 
than Ne continue executing commands; 
otherwise, skip to the corresponding SELSE or 
SENDC. 


specifies that if the nth parameter does not 


exist, continue executing commands; otherwise, 
skip to the corresponding SELSE or SENDC. 


specifies that if the nth parameter exists, 
continue executing commanis; otherwise, skip 
to the corresponding SELSE or SENDC. 


specifies that if fd does not exist, continue 
executing commands; otherwise, skip to the 
corresponding SELSE or SENDC. 

specifies that if fd exists, continue 
executing commands; otherwise, skip to the 
corresponding SELSE or SENDC. 

starts a job, resets end of task coda. 
prevents a listing... 

Suspends a CSS file. 

skips to STERMJOB. 

specifies end of job (EQJ). Any SSKIP or 
error condition within this job zausas CSS 
processing to transfer to this command with 
end of task code=255; otherwise, end of task 


code is defined by the job itself. 


transfers out cf current CS3S and enters a new 
cSS. 


suspends a CSS for a specified period of time. 


logs a message to the system console and, if 
present, the system log file. 


5.12 CSS ERROR CONDITIONS 


The following is a list of errors possible after issuing CSS 


commands: 


BUFF-ERR 


FD-ERR 


FORM-EPR 


IO-ERR 


JOBS-ERR- 


LVL-ERR 


MNEM-ERR 


PAUS-ERR 


PARM-ERR 


SEQ-ERR 


tn 


ae A 


indicates that expanded command line exceeds 
CSS buffer; skips to STERMJOB. 


indicates there is not enough Space to build 
a file or required file support not in systen; 
skips to STERNJOB. 


indicates command syntax error; skips to 
STERMJO3B. 


‘indicates STERMJOB was founil while skipping to 


SENDC within a job. Sets end of task code to 
255 and ends job. (This is only detected if 
the conditional that caused the skip was also 
inside the job; i.e., a skip to SENDC zan skip 
over a complete job.) 


Or 


EOF was found while skipping ts SENDC; #=skips 
to STERMJOB. 


Or 


EOF was found before ($)ENDB while’ (S$)BUILD a 
file; skips to STERMJOB. 


indicates second SJOB was encounterei; raturns 
control to console. 


indicates that required CSS Levels exceed the 
number of levels sysgened; returns control to 
console. 


indicates command is not rezognized; skips to 
STERMJOB. 


indicates SPAUSE was entered fron system 
console. 

indicates command syntax error; skips to 
STERMJOB. 


indicates a: task was active; returns control 
to console. 
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TASK-ERR 


WAIT-ERR 


indicates that currently selected CS§ 


not in system; skips to STERMJOB. 


indicates SWAIT was entered fron 


console. 


NOTE 


The program skips to STERMNJOB if an error 
is detected within a CSS job. The job is 
aborted and the next command obeyed is 
the first command after the STERMJOB, at 
which point the end of task code is 255. 
If the error occurs outside a job, 
control is returned to the console. 
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task is 


system 


# 


CHAPTER 6 
ACCOUNTING DATA COLLECTION AND REPORTING 


6-1 INTRODUCTION 


Data regarding system usage is collected via the Accounting 
Facility and reported via the Accounting Reporting Utility. The 
Accounting Facility is available for systems running in both an 
MIM environment or a non-MTM environment. 


6.2 ESTABLISHING THE ACCOUNTING FACILITY IN AN MTM ENVIRONMENT 


See the Multi-Terminal Monitor Reference Manual for the 
procedures involved in establishing the data collection component 
of the Accounting Facility. See the System Support Utilities 
Reference Manual for the procedures involved in reporting 
Accounting Facility data. 


6.3 ESTABLISHING THE ACCOUNTING FACILITY IN A NON-MTM 
ENVIRONMENT 


Systems operating in a non-MTM environment can also collect and 
report accounting data through the use of a dummy accounting. 
task. 


If a system does not use HMTM, an OS sysgen with accounting 
support must be performed. A dummy task (MTM taskid), that 
performs the data collection duties of the Aczounting Facility, 
is then loaded and started using the following command sequence: 


LOAD .MTM. AFDCP 
TASK .MTM 
START , ATF = fd 


The AFDCP is able tec accapt two MTM commands. 


~-MTM QUIESCE 
HTM ATE £d : 


The MIM QUIESCE command terminates AFDCP. The MIM command 
changes the accounting transaction file to the specifiei Fd. fhe 
current ATF is closed and a new ATF is allocated (if necessary) 
and assigned. 


Refer to the OS/32 Multi-Terminal Monitor (MTM) Reference Manual 
for a description of the various Accounting Facility commands and 
to the OS/32 System Support Utilities Reference Manual for a 
descrintion of the Reporting Utility commands. 
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ALLOCATE fd, 


ASSIGN lu,fdl, 


(eget 


HAeANARAN FAN RAN 


IH 


0 


N 


peer ey et 
SEAM i ao $ : Ll # f " eaves | 


APPENDIX A 
OPERATOR COMMAND SUMMARY 


keys | 
NTIGUOUS,fs81ze2 |, 


DPRVOE ) 
a 
oe rf Rec} 


. [eas] [ies 
ie 


access privileges 


Used for magnetic tapes and cassettes only 


Used for disk devices only 


BRECORD fd Used for magnetic tapes and cassettes only 


BRECORD fd [,1u] Used for disk devices only 


BUILD £4 [, APPEND] 


ENDB 
CANCEL taskid 


lu, [,1lu, ee elu, 
CLOSE 
ALL 


CONTINUE [address] 


DELETE fd, [-£4, ree re 


| taskid fd | 
“DISPLAY ACCOUNTING |,<_ ; ee | 
| a 4 = 


fd 
DISPLAY DEVICES |, 
: cS ole 


DISPLAY 


DISPLAY 


voln: filename | ext 
DISPLAY FILES |, Se * ‘ 
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DISPLAY 


DISPLAY ITAMTERM jvoins} 


DISPLAY LU zi 


DISPLAY MAP |/ 


DISPLAY PARAMETERS 4 : 
DISPLAY REGISTERS [,£d] 


DISPLAY TIME fi 


filename 


48-030 FOO ROO 


minutes 
ERROR PERIOD |x, | 
* 


ON 
ERROR RECORDING ,fd, 
OFF 


en 


EXAMINE address, 


FFILE fd Used for magnetic tapes and cassettes only 
FFILE fa [,lu] Used for disk devices only 
FRECORD fd _ Used for magnetic tapes and cassettes only 


FRECORD fd [-1u ] Used for disk devices only 


segsize increment 
INIT fd |, 7 
4 


fd [,segsize increment] 


taskid [. [fa] [,segsize increment] | 
sysid,fa [,segsize increment] 
-BG,fd [,segsize increment] 

-TCM,£d 

-LIB,fd 


-SEG,fd 
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a; 


PARAHETER[,RECL=rec1] [,SIZE=size] > 


or sare 


MARK dev:,)OFF 


PROTECTED | bsize exp 
ON ; SYSTEM eCDIRECTORY |=) 1, ee 
RESTRICTED | | pias) 400: 


OFF,address [-size| 
EMORY J ON,address [,size| 
TEST,address [-size] 


n 


| 


1O 
ia o 
a 
ri 
Oo 
= 
YQ 
teen get, 
le 
ry] 
iQ 
© 
<4 
tae] 
| ee: 
“ & 
rion ino 
: ry 
W 
ei 
Yo 
ra] 
Ze 
3 
SN 
| eee | 
| a } 
tee 
Se) 
i< 
iQ 
IQ 


REMOVE .SEG,Segment name 
RENAME oldfd,newfd 


REPROTECT fd,new keys 


REWIND £d ' Used for magnetic tapes and 
. or cassettes only 
RW fd 
REWIND £4 [,1u] Used for disk devices only 
Or 
RW £d [,lu] 


SEND message[; | 
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[mm/dd/yy] ,hh:nn:ss 
SET TIME OFF 


Q 


address a 
DIART ; " [-paraneter,,.+-,parameter, | 


TASK [taskid] 


TCOM segment name,segment size 


CONTIGUOUS,fsize 
TEMEFILE lu, lrecl bsize isize 
INDEX |,}¢ ‘Wo ETS eat 
126 & a 
SYSTEM 
TASK 
TEMPORARY 


VOLUME] voln!/ 


WFEILE fd Used for magnetic tapes and cassettes only 


WEILE fd [,1u] Used for disk devices only 
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keys 
CONTIGUOUS, fsize |, 
pov. 


3 eet tone 
ITAM|, 7 


XALLOCATE fd, 


XDELETE £4, [pfa,,-.+ fds] 


OPERATOR CSS COMMAND SUMMARY 


BUILD fd [, APPEND] 
ENDB 
SET CODE n 


SBUILD fd 
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SIFE n 
SIFG n 
SIFL n 
SIFNE no 
SIFNG on 
SIFNL oa 


SIFNNULL on 


we et ee ee 


SIFNX fd 
SIFX f4 


SJOB 


Ty gee Wee 


SNOCOPY 


RANSFE 


Kn 


SHRITE 


R 
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APPENDIX B 
OPERATOR COHHAND NESSAGE SUMHARY 


ALLO-~ERR TYPE=NAME 


Desired filename currently exists on the specified volume. 


ALLO-ERR TYPE=SIZE 
Insufficient room available on the disk to allocate the file. 


Block size of indexed file exceeds limit established at 
sysgen. 


For an indexed file, a zero logical record length or block ~ 
Size was specified. : 


ALLO-ERR TYPE=TYPE 


The volume specified is not a direct access device. Ensure 
that specified volume is the disk volume name, not its device 
name. 


ALLO-ERR TYPE=VOL 


Volume name specified or the default volume is not the name 
of any disk currently online. Ensure that desired disk is 
online. 

ARGS-ERR 
The amount of space between CTOP and UTOP is insufficient for 


the command processor to place the parameters of the START 
command. 


ASGN-ERR 


Optional fd or disk device of voln could not be assigned; 
e.g», fd or disk is assigned for exclusive use only. 
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ASGN-ERR TYPE=BUFF 


An attempt was made to assign a file when there was 
insufficient system space available to accommodate the FCB. 
Close any currently assigned files that are no longer 
required, or increase the size of system space with a SET SYS 


command. 


ASGN-ERR TYPE=LOU 


An attempt was made to assign an lu that is greater than the 
maxlu number specified at Link time. 


ASGN-ERR TYPE=NAME 


An assignment was directed at a nonexistent file. 


ASGN-ERR TYPE=PRIV 


A file that is currently assigned to an lu with ae given 
Privilege could not be assigned to another lu beacause the 
access privileges were in conflict. Request a stompatible 
access privilege on second asSignment or change the access 
privileges currently associated with the file. 


ASGN-ERR TYPE=PROT 
The file assigned is unconditionally protected or thie 


read/write keys specified in the assign statement do not 
correspond to those associated with the file. 


ASGN-ERR TYPE=SIZE 
An indexed file was assigned and there is not enough room 09n 
the disk to allocate a physical block. Ensure sufficient 
space on the disk by deleting old files or reducing the block 
Size of the file. Alternatively compress the disk using \the 
Disk Backup Utility. 

ASGN-ERR TYPE=SPAC 
An attempt was made to assign a file that exceeds the task 
maximum system space allotment. 


ASGN~ERR TYPE=TGD 


An attempt was made to assign a trap generating device that 
is not assignable. 
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ASGN-ERR TYPE=VOL 


Volume name specified or default volume is not the name of 
any disk currently online. 


ATTN-ERR 
The priority specified in an ATTN command was not a decimal 
number from 2 through 249. 
fd-BAD LINE COUNT 
The value of n in a -SPL FORWARD or BACKWARD command exceedad 
file limits. : a 
BPAC-ERR 
The disk was not ready or was not readable. If the disk is 
ready and is not write-protected, reformat using the Disk 


Initializer Utility. 


‘ 


BUFF-ERR 
The expanded CSS line exceeds the CSS buffer size. Specify 
larger CSS buffer length at next sysgen or modify C35 
Statements. Ensure that the expanded CSS line does not 
overflow the buffer. by shortening the length of the 
unexpanded line. . 


CLOS-ERR TYPE=LU 


The lu is greater than maxlu specified at Link time. 


CLOS-ERR TYPE=BUFF 


System space has become corrupted and buffers ani/or file 
control blocks cannot be returned to the free system space. 


fd IS NOT A CONTIGUOUS FILE 


The fd specified in an INIT command is not a contiguous file. 


DATE-ERR 
An ERROR LOG command was entered with the ON parameter 


specified, but the date and time parameters of the SET TINE 
command were not specified. 
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DELE-~ERR TYPE=ASGN 


An attempt was made to delete a file that is current] 
assigned. 


DELE-ERR TYPE=BUFF 
There is insufficient available memory in system space t 
perform the delete operation. Enlarge system space with 


SET SYS command or make more space available by closing on 
or nore logical units. 


DELE-ERR TYPE=TYPE 
The volume name specified or default volume is not a direc 
access device. 

DEV-ERR 
An attempt was made to mark on or otf a nonexistent device o 
a pseudo device: or an attempt was made to modify th 
attributes of a nonexistent device or bulk device. 

DEVICE NOT A DISK 


The specified device with voln is not a bulk device. 


DIR-ERR 
A DISPLAY FILES command was directed at a disk containing one 
or more invalid directory entries. Run the Disk Integrity 
Check Utility to verify the contents of the disk pack. 
DUPL-ERR 
When marking on a direct access device, the volume name 
associated with the device was an existing device or volume 
namee Run the Disk Initializer Utility to change the disk 
volume name, or mark the other disk offline. 


ERRC-ERR 


A DISPLAY ERRORS or ERROR RECORDING command was entered, but 
error recording was not Specified at sysgen. 
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ASGN-ERR TYPE=VOL 


Volume -name specified or default volume is not the name of 
“any disk currently online. 


ATTN-ERR 


The priority specified in an ATTN command was not a decimal 
number from 2 through 249. 


fd-BAD LINE COUNT. 


The value of n in a .-SPL FORWARD or BACKWARD commani exceeded 
file limits. 


BPAC-ERR 


The disk was not ready or was not readable. If the disk is 
ready and is not write-protected, reformat using the Disk 
Initializer Utility. 


BUFF-ERR 
The expanded CSS line exceeds. the CSS buffer size. Specify 
larger CSS buffer length at next. sysgen or modify C3S 
statements. Ensure that the expanded CSS line does not 


overflow the buffer by shortening the length of the 
unexpanded line. 


CLOS-ERR TYPE=LU 


The lu is greater than maxlu specified at Link time. 


CLOS-ERR TYPE=BUFF 
System space has become corrupted and buffers ani/or file 
control blocks cannot be returned to the free system space. 
fd IS NOT A CONTIGUOUS FILE 


The fd specified in an INIT command is not a contiguous file. 


DATE-ERR 
An ERROR LOG command was entered with the ON paramater 


specified, but the date and time parameters of the SET TIME 
command were not specified. 
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DELE-ERR TYPE=ASGN 


An attempt was made to delete a file that is currently 
assigned. 


DELE-ERR TYPE=BUFF 
There is insufficient available memory in system space to 
perform the delete operation. Enlarge system space with a 


SET SYS command or make more‘ Space available by closing one 
or more logical units. 


DELE-ERR TYPE=TYPE 


The volume name specified or default volume is not a= direct 
access device. 


' DEV-ERR 
An attempt was made to mark on Or otf a nonexistent device or 


a pseudo device; or an attempt was made to modify the 
attributes of a nonexistent device or bulk device. 


DEVICE NOT A DISK 


The specified device with voln is not a bulk device. 


DIR-ERR 
A DISPLAY FILES command was directed at a disk containing one 


or more invalid directory entries. Run the Disk Integrity 
Check Utility to verify the contents of the disk pack. 


DUPL-ERR 
When marking ona direct access device, the volume name 
associated with the device was an existing device or volume 
name@e Run the Disk Initializer Utility to change the disk 
volume name, or mark the other disk offline. 


ERRC-ERR 


A DISPLAY ERRORS or ERROR RECORDING command was entered, but 
error recording was not specified at sysgen. 
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xxxx ERROR ON fd SECTOR n 


An I/0 error occurred when an attempt was made to initialize 
sector n of file fd. xxxx is the type of error. 


FD-ERR 


The fd was syntactically incorrect; or a program on the disk 
was being loaded, and there was not enough system space for 
the load operation. 


FETCH ATTR ERR 


A fetch attributes failed on secondary directory when marking 
on protected with secondary directory. 


FILE NOT FOUND 


The specified file was not found. 


FILE filename NOT ON QUEUE 


The file specified by the PURGE parameter of the .SPL command 
is not on the Spooler queue. | 


FILE filename SPOOLING 


The file specified by the PURGE parameter of the .SPL command 
is currently being spooled out. 


FORM-ERR 


The command format was syntactically incorrect. 


IDLE-ERR 


A .SPL REWIND, CANCEL, FORWARD, BACKWARD, or CONTINUE command 
was isssued to an idle device. Verify the name of the device 
to which the command is directed. 


INVALID FD=£d 


The filename specified is a device, not a file, or the device 
specified is not a valid pseudo device. 
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An invalid fd was specified with the PRINT or PUNCH parameter 
of the .~.SPL command. 


I/O~-ERR 


AR device accessed by the command processor returned a nonzero 
I/O status. These type fields can be displayed: 


TYPE=PRTY - Parity or other recoverable error. Retry the 
operation with another unit, if possible. 


TYPE=UNRV - An unrecoverable error occurred. 

TYPE=UNRV SEGMENT=SS TYPE=IMPU - An error occurred while 
writing the impure segment of the segment name (SS) out to 
its roll file in order to read task R3 into MEMOLY. No 
action is necessary. The segment SS has heen flagged 
nonrollable. 

TYPE=EOF,EOM - The device reached EOF or EOM before 


completing the operation. 


TYPE=DU - The device is unavailable. Ensure that the jevice 
is online and ready. 


TYPE=FUNC - An invalid operation is being directed toward a 
device; eege, attenpting to write to a reai-only device. 


TYPE=LU - Illegal or unassigned lu. Close and reassign 
proper lu. 


INIT-ERR 
Memory error recording was initialized, but it already had 
been specified and was in progress. 
JOBS-ERR 
A S$JOB statement was encountered following another SJOB 
Statement but prior to a STERMJOB statement. 
LOAD-ERR TYPE=IO 
An I/O error was generated during the load operation. Retry 
the load operation. If the same condition results, verify 
the status of the medium from which the task is being loaded. 
LOAD-ERR TYPE=LIB 
The data in the LIB was invalid. This error most frequently 


occurs when an attempt is made to load a task whith was not 
established with Link. 
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" LOAD-ERR TYPE=LOPT 


Conflict between load options requested ani those specified 
at Link time. 


LOAD-ERR TYPE=MAP 
While loading a task, an attempt was made to automatically 


load asharable segment, but fd could not be found or the 
shared segment table overflowed. 


LOAD-ERR TYPE=MEWN 
Rh load was attempted when no memory area large enough was 
available. Change priorities or rollability of current tasks 
to allow a roll operation to occur, or cancel one or more 
current tasks. 


LOAD~ERR TYPE=MTCB 
An attempt was made to toad more tasks than the system 
permits. 

LOAD-ERR TYPE=NOFP 
An attempt was made to load a task requiring floating point 
support, and the required floating point option is not. 
supported in the system. 

LOAD-ERR TYPE=PRES 


The specified taskid is already present in the systen. 


LOAD-ERR TYPE=PURE 


Puplicate pure segment name. 


LOAD-ERR TYPE=ROIO 
I/O error encountered in writing roll file. Retry the load 


cperaticn. BOs a the same condition occurs, verify the status 
of the roll volume. 


LOAD-ERR TYPE=RVOL 
Allocation or assignment error on roll file. Ensure that the 


roll volume is online and write enabled. Retry the load 
operation. 
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LOAD-ERR TYPE=SEG 


An attempt was made to load a task requiring the RTL or 
TCOM prior to establishing an RTL or TCOM segment. 


LOAD-ERR TYPE=SPAC 


Not enough system Space for loader TCB. Increase syste 
Space. 


LU-ERR 


An invalid lu number or lu was asSigned; an invalid fd wa: 
encountered; or a nonzero account number was specified. 


LYL-ERR 


The number of sysgened CSS levels was exceeded. 


MEM-ERR 


The system contains insufficient memory to support. the 
command request. 


MNEM-ERR 


The entered command was not recognized. 


NOBC-—ERR 
A BFILE, BRECORD, FFILE, or FRECORD commani was entered anj3 


bulk file commani support is not included in the operatince 
systen. 


NODA-ERR 


Direct access support was not included in target systen. 


NO DIRECTORY ENTRIES ON voln 


The specified volume has no files on it. 


NOFF-ERR 


An attempt was made to mark on a disk device when the 
integrity of the data on the disk was questionable. Run the 
Disk Integrity Check Utility on the disc. The disk can be 
marked on protected. 
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NOFP-ERR 


No floating point support exists in the systen. 


NOPR-ERE 


A command was entered that required more parameters than 


specified in the command line. 


NROL-ERR 


An OPTIONS ROLL command was directed to a nonrollable task. 


NO SYSTEM SPACE 


An attempt to mark a disk online with a secondary 


directory 


option failed because there was not enough system space 


available for creating a secondary directory block. 


NSUP-ERR 


The device does not support error recording. 


NULL-ERR 


An attempt was made to rename the null device. 


OFF-ERR 


An ERROR LOG command specified the OFF parameter, 
error recording function was already off. 


ON-ERR 
An ERROR LOG command was entered twice with the ON 
specified. 

OPT-ERR 


but the 


parameter 


A conflict exists between requested options and options 


specified at Link time. 


OSP-ERR 


A device specified ina .SPL REWIND, CONTINUE, FORWARD, or 


BACKWARD command is not an output spool device. 
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PARM-ERR 


A command was entered with invalid parameters. 


PERD-ERR 


The number of minutes specified for the error log readout 
period was not a number from 1 through 1440. 


PRES-ERR 


An ERROR LOG command was entered, but the operating system 
does not support error reporting. 


PRI-DIR READ ERR 
An attempt to mark a disk online with a sSacondary directory 
option failed because an I/0 error occurred when reading the 
primary directory. 

PRIV-ERR 


The access privilege mnemonic was syntactizally incorrect. 


PRTY-ERR 
A SET PRIORITY command was entered, and the requested 
priority is greater than the maximum priority set at Link 
time. 

READ-ERR 
An attempt was made to mark a disk online that is not 
hardware enabled for write, or that returns an I/O error when 
it is accessed. 

REM~-ERR 
Attempt to remove a segment feiled for reason noted in IYPE 
field. 

RENM-ERR TYPE=ASGN 
The file or device cannot be assigned for ERW “(required to 


perform the rename) because the file or jievice is currently 
assigned to at least one lu. 
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RENM-ERR TYPE=NAME 


The new filename already exists in the volume directory, or 
‘the new device name already exists within the DMT. 


REPR-ERR TYPE=ASGN 


The file or device cannot be assigned for ERW (required for 
reprotection) because the file or device is currently 
assigned to at least one lu. 


ROLL-ERR 


A BIAS * command was entered and the currently selected task 
is rollable, or BIAS * taskid was entered and taskid is a 
rollable task. 


SEC-DIR ALLO ERR 
An attempt to mark a disk online with a secondary directory 
option failed because there was insufficient Space on the 
disk or the disk was write-protected (hardware feature). 

SEC-DIR ASGN ERR 
Assignment to secondary directory failed during marking on 
protected with secondary directory. 

SEC-DIR DELE ERR 
DELETE command to old secondary directory failed because old 
file was not properly closed. 

SEC-DIR NOT PRESENT 
Secondary directory does not exist on disk and mark on 
protected with secondary directory was attempted. 

SEC-DIR READ ERR 
An attempt to mark a disk online protected with a secondary 
directory option failed because an I/O arror occurred when 
reading the secondary directory. 

SEC-DIR VERIFY ERR 


secondary directory failed to verify with the primary 
directory when marking on protected with secondary lirectory. 
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SEC-DIR WRIT ERR 


An attempt to mark a disk online with a sacondary directory 
option failed because an I/0 error occurrei when establishing 
the secondary directory on the disc. 


SEGMENT REQUEST NOT FOUND 


A DISPLAY MAP command was entered, and the requestei segment 
mask was not found, or no tasks exist in memory. 


SEQ-ERR 


A command was entered out of sequence when: 


- attempting to pause a task when none was active, 


- assigning to 32 currently assigned lu while a task was 
active, or 


- entering an OPTION command for an active task. 


SKIP-ERR 


An attempt was made to skip beyond the end of a C5S job. The 
CSS job concept delimits CSS jobs with the S$JOB and STERMJOB 
statements. Conditional CSS statements allow skipping to a 
SENDC if certain conditions are met. If the nesting of 
conditional statements is incorrect, a STERMJOB statement can 
be encountered prior to terminating all of the conditional 
statements. 


SLOC-ERR 
The starting location of a task was specified below UBOT or 
was omitted when it was required. 

SPAC-ERR 
An assign on behalf of a task was refused because system. 
Space available for task use was exceeded. Reestablish the 
task with a larger maximum system space. 

SPECIFIED TERMINAL(S) NON-EXISTENT FOR voln 


The communications terminal specified in a DISPLAY ITAMIERM 
command was not found, or voln has no LCBs allocated for it. 
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STAT-ERR 


An attempt was made to mark a device online or offline while 
an lu was assigned to it. 


SVC6-ERR TYPE=ARGS 


Insufficient memory exists between UTOP and CTOP to pass all 
Parameters. 


SVC6-ERR TYPE=NMSG 
hk SEND command was entered and the receiving task souli not 
receive a message trap. 

SVC6-ERR TYPE=DORN 
An attempt was made to issue an SVC 6 to a task that was in 


the dormant state. 


SVC6-ERR TYPE=PRES 


An attempt was made to send a message to a nonexistent task. 


TASK-ERR 
A task related command was entered and there was no currently 
selected task. 

TCOM-ERR 
A TCOM command failed for one of the following reasons: 


- TYPE=MEM - No vacant area of sufficient size exists. 


~ TYPE=NAME - A task common of the same name alreaiy exists. 


- TYPE=SYS - Not enough system space exists for required 
. segment descriptor entry. 
~ TKID-ERR 
An invalid taskid syntax was entered on a LOAD command. 
WRIT-ERR 
An attempt was made to mark a device that is hardware 


protected online without the PROTECT option. Use the PROTECT 
option in the MARK command. 
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APPENDIX C 
SYSTEN MESSAGES 


TASK RELATED MESSAGES: 


taskid: TASK PAUSED 
Task taskid paused. Results from SVC 2 cole 7 or operator 
’ PAUSE command.’ : 
taskid: END OF TASK n 


Task taskid has ended. The EOT code in decimal is n.°:' 


taskid: ILLEGAL INSTRUCTION AT xxxxx (yyyyyy) 
Tilegal instruction fault detected at location xxxxx in the 
‘taskid address space (physical address yyyyyy)-.- 
taskid: ILLEGAL SVC AT xxxxx (yyyyyy) 
Illegal SVC call at location xxxxx in the taskii address 
space (physical address yyyyyy).- 
taskid: INVALID SEGMENT ADDRESS ERROR AT xxxxx Cyyyyy) 
The task tried to address a segment outside the segment size 
of the program. Program address is xxxxx; Physical address 
is yyyyy. 
s taskid: ADDRESS FAULT IN SVC AT xxxxx (Cyyyyyy) 
Address of SVC parameter block or an address parameter in the 
- parameter block is outside the task taskid memory allocation, 
or is not properly aligned. ‘ 
taskid: ARITHMETIC FAULT AT ‘'xxxxx (Cyyyyyy) 


Arithmetic fault is detected at location xxxxx in the taskid 
address space (physical address yyyyyy).- 
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taskid: MEMORY PARITY ERROR AT xxxxx (yyyyyy) > 


Parity machine malfunction is detected at location xxxxx 
(physical address yyyyyy). 


taskid: MEMORY FAULT AT xxxxx (Cyyyyyy) 


The task attempted to access memory outside its allowable 
Limits. Program address iS xxxxx; phySical address is 


YYYYvYY. 

taskid: I/O-ERR TYPE=xxxx SEGNAME=yyyy SEGIYPE=2222 
I/O error type xxxx waS encountered while trying to roll out 
the segment named yyyy to the roll volume. Task space is 
needed to load or roll in task taskid. Segment yyyy will be 
set as nonrollable, and write error flag will be set in the 


‘SDE. To insure full integrity of the segment, reload the 
Pertinent modules. 


taskid> 
SVC 1 read request to console device from task taskid. Data. 


should be entered as soon aS possible to prevent blocking the 
console. 


SYSTEM RELATED MESSAGES: 


OS32MTrr-uu 
Printed after system initialization. The release level is 
ro; uu is the update level. 

POWER RESTORE - RESET PERIPHERALS AND ENTER GO 
Power fail restore sequence; type GO (CR) to complete power 
recovery. 

POWER RESTORE - RESET PERIPHERALS 


Power fail restore sequence; no operator response required. 


- 


CDIR FULL-devn 


The core directory on disk devn is full. Refer to the MARK 
command description in Chapter 3 for required action. 
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EE EEE PEE LE TE ET CE 


I/O ERROR ON voln; MARK OFF AND CHECK 
BIT MAP ERROR ON voln:; MARK OFF AND CHECK 


voln is the disk volume name. An I/O error is reported to 
the system when reading or writing a directory block, bit map 
sector, or volume descriptor (map sector 0)- A bit map error 
is xreported to the system console in the event of a bit map 
error, i.e., allocating an already allocated sector or 
volume, or releasing an already released sector. 


When either of -these errors occurs, any operations that 
require bit map changes are rejected with device unavailable 
status. This action permits read and write to -preallocated 
contiguous files and read only to the preallocated index 
files. An attempt to allocate or delete a file is rejected 
with device unavailable status. The operator is advised to 
run a disk check on that disc. 
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APPENDIX D 
SYSTEM CRASH CODES 


A system crash occurs when the operating system ietects an 
unrecoverable internal error. When a crash occurs, the system 

prints out a message to the system console informing the operator 
of the system crash and gives a crash code number. This number 
can be used as a diagnostic to help determine the cause for 
system failure. 


The system sysgen parameter, SGN.SAFE, controls the inclusion of 
safety checking code into the operating system modules. This 
code is dispersed throughout the system. It performs consistency 
checks at various places in the operating system code. If a 
consistency check fails, then a system crash occurs. 


Generally, distributed systems are assembled with SGN.SAFE set to 
zero because the safety check code increases operating system 
overhead. However, if modifications are to be made to the 
system, it is recommended that the system be reassembled with 
SGN.SAFE equated to 1 to assemble in the chacks. These checks 
allow the operating system to detect internal errors sooner, 
making it easier to track down problems. 


The system signals a crash by executing a SINT instruction on 
device zero. The resulting I/O interrupt causes control to be 
passed to the crash handler. The crash handler prints out the 
crash message, which includes the crash code. 


After the system has crashed, registers 0, 1, 2, and 3 of 


register set 0 have been destroyed. Registers O and 1 of 
register set 0 contain the PSW that was active at the time that 
the crash SINT instruction was executed. Note that the 


destruction of these registers makes it more difficult to track 
down problems in ISRS because these routines use ragisters 0 
through 7 of register set 0. 


In the following list of crash codes, an asterisk following the 


crash code indicates that the crash code only occurs in systems 


assembled with SGN.SAFE equated to 1. The other crash codes 
occur in any system. The crash code descriptions include 
registers that contain information that might help find the 
problem. The register set referred to in these descriptions is 
the same register set used in the PSW saved in register 0 of set 
Q. 
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Crash code: 1 
Modules: CMON, CMSP 


The system console device mnenomic from SPT.IVE was not found in 
the DMT, or CMON was unable to start CHDP. CMDP could not assign 
the system console device, or the write of the operating oT Scen 
header message returned bad status. 


Crash codes 3 
Module: CMON 


CMON received an unexpected item on its task queve. RF contains 
the item that was found on the task queue. 


Crash code: 4 
Module: EXIN 


The address of the MAC is larger than the value specified in the 
CUP DEVADS statement. 


Crash code: 5 
Module: EXIN 


An operating system sysgened with hardware floating point support 
attempted to execute hardware instructions on a machine not 
equipped with floating point hardware. 


Crash code: 7 
Module: CMDB 


An online disc was discovered to have no associatad entry in the 
VMT. 


Crash code: 10 
Module: CMDB 


An attempt to mark a disc on or off occurred, but direst access 
support is not incluied in the system. This crash can occur only 
when disc devices are included into a system without direc 

access support. | 


Crash code: 100 
Modules: EXIN 


An arithmetic fault occurred while a user task was executing in 
RS or RSA state. The contents of register set 0 at the time the 
fault was detected are saved at EREGS. Registers RE and RF 
contain the interrupt old PSW. 
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Crash code: 101 
Module: EXIN 


An arithmetic fault occurred while executing system code, but RS 
or RSA state was not entered on behalf of a user task. The 
contents of register seat 0 at the time the fault was detected is 
saved at EREGS. Registers RE and RF contain the interrupt old 


PSW. 
Crash code: 102 


Module: EXIN 


An illegal instruction was executed in system code. The contents 
of register set 0 at the time the fault was detected ara saved at 
EREGS. Registers RE and RF contain the interrupt old PSW. 


Crash code: 106 
Module: EXIN 


An SVC interrupt occurred, but the SVC instruction that caused 


the interrupt was not found as expected. RA contains the 
relocated address of the $=§instruction following the SVC 
instruction that caused the interrupt. RC contains the 


unrelocated address of the instruction following the svc 
instruction that caused the interrupt. The contents of register 
set 0 at the time the fault was detected are saved at EREGS. 
Registers RE and RF contain the interrupt old PSW. 


Crash code: 1067* 
Modules: EXIM 


TMUCHN is trying to remove a task with an invalid TCB address 
from the ready chain. Register RY contains the address of the 
current TCB. 


Crash codes: 108* 
Module: EXTH 


TMREMW is trying to renove wait conditions from a task whose TI72B 
address is invalid. Register RY contains the address of the 
current TCB. Register RD contains the wait bit masks that are to 
be reset. 


Crash code: 109 
Module: EXTM 
TMRDISP is trying to dispatch the top of the ready chain, but the 


TCB address of this task is invalid. Register R9 contains the 
address of the current TCB. 
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Crash code: 10B* 
Module: EXTM 


TMCHN is trying to put a task with an invalid fTCB address onto 
the ready chain. Register 89 contains the address of the current 
TCR. 


Crash code: toOCc* 
Module: EXTM 


SV9.ATQ, SV9-ATO1, SV9.~ATQ2, SVI.ASQ, or SVO.~ASQ1 is trying to 
add anh item to a task’s task queue, but the TCB address is 
invalid. Register R9 contains the address of the current ICB. 
Register RA contains the parameter that is to be adied to the 
task queue. - | 


Crash code: 10D* 
Module: EXTH 


A task is being dispatched into user state by TMRDISP, ani thea 
task owns the user register set. Although owning the user 
register set implies ownership of the MAC, the task does not own 
the MAC. Register R9 contains the address of the current TCB. 
Register RC contains the value that was expected in SPT.MCOW. 


Crash code: 10E* 
Module: EXTM 


TMRDISP found that the last task executing was interrupted iuring 
an interruptable instruction. The TCB of this task was obtained, 
but was found invalid. Register R@ contains the TCB address of 
the task baing dispatched. Register RY contains the TCB address 
of the interrupted task. Registers RE andi RF contain the 
dispatch PSH. 


Crash code: 116* 
Modules EXTM 


TMSTRT is trying to start a dormant task, but the TCB address is 
invalid. Register RG contains the address of the current TCB. 
Register RF contains the unrelocated starting address of the 
task. 


Crash code: 111* 
Module: EXT 


THREMW was trying to remove wait conditions from a task, but the 
wait conditions to be removed were not valid. Register R9 
contains the address of the current TCB. Register RD contains 
the wait bit masks that are to be reset. RB contains the invalid 
wait bit masks that caused the crash. 


D-4 — 48-030 FOO ROO 


“s 
. vey 


Crash code: 115* 
Module: EXTM 


[TMSTOP finds that the TC3 address of the task whose registers are 
to be saved is invalid. Register RY contains the address of the 


current TCB. 


Crash code: 118 
Module: EXTM 


TMUCHN is trying to remove a task from the ready chain that is 
absent from the chains Register R9 contains the address of the 
current TCB. . 


Crash code: 419 
Module: EXIN- 


A MAC fault occurred while executing system coie. The contents 
of register set 0 at the time the fault was detected ara saved at 
EREGS. Registers RE and RF contain the interrupt old PSW. 


Crash code: 121* 
Module: EAMY 


PELMEM is trying to release a task memory block not in task 
memorvs; or, during the release of the memory, the free list for 
task memory was found not to be in increasing address order. 


Crash code: 122* 
Module: EXUY 


RELSYP is trying to release a system space block that does not 
exist in system space; or, during the release of the memory, the 
free list for system space was found not to be in decreasing 
address order. Register RY contains the address of the current 
TCB.e. The value of Register R9Y can be zero. 


Crash code: 131 
Modules EXIN 


An SVC was issued, but there is no current task. The contents of 
register set 0 at the time the fault was.detected are saved at 
EREGS. Registers RE and RF contain the interrupt old PSW.e 


Crash code: 132 
Module: EXIN 


An illegal SVC call was issued from system coie. This can be 
caused by issuing an SVC with an invalid SVC number, such as 0, 
or by using an invalid SVC 2 code. The contents of register set 
0 at the time the fault was detected are saved at EREGS. 
Registers RE and RF contain the interrupt old PSW. 
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Crash codes: T4U2 
Modules EXIN 


An SVC has an invalid address block address, or a parameter 
inside the parameter block is invalid. This could be caused by 
not having the parameter block fullword aligned. The contents of 
register set 0 at the time the fault was detected are saved at 
EREGS. Registers RE and RF contain the interrupt old PS¥W. 


Crash code: 1445 | 
Modules EXIN 


A reason code from a MAT fault should never occur. The contents 
of register set O at the time the fault was detected are saved at 
ERESS. Registers RE and RF contain the interrupt old PSW. 


Crash cade: 1450 
Module: FLTP 


A bad vector table offset was generated while processing an op 
code to see if it was a floating point instruction. . 


Crash code: 152 
Modules EXIN 


A parity error accurred while executing system cole. This fault 
can be caused by referencing an address outside of physical 
memory or .a noncorrectable "Nemory error. The contents of 
register set OQ at the time the fault was detected are saved at 
EREGS. Locations 20 through 27 contain the current PSH at the 
time of the machine malfunction interrupt. For Perkin-Elmer 
3220, 3230, and 3240 machines, locations 2C through 2F and 44 
through U7 contain the physical address that caused the 
interrupt. The word at Locations 40 through 43 contains a reason 
code for the interrupt. 


Crash code: 153 
Module: EXIN 


An instruction data, format, or alignment fault occurred in 
system code. This fault can only occur on a Perkin-Elmer 3200 
machinee The contents of register sat 0 at the time the fault 
Was detected is saved at EREGS.~ Registers RE and RF contain the 
interrupt old PSW. 


Crash code: 175 
Module: EXSP 


An SVC 2 call was made from system code, but the RS register seat 
iS not owned by the caller. Register RY contains the address of 
the current TCB. Register RA contains tha value that was 
expected to be found in either SPT.RSOW or SPT.UIOW. . 


D-6 48-030 FOO ROO 


Crash code: 176* 
Module: EXTM 


TMRSRSA or TMRSARS found that the RS register set is not properly 
owned by the calling task. Register R2 contains the address of 
the current .TCB. Register R8 ‘contains the value that was 
expected to be found in either SPT.RSOW or SPT.UTOW. 


Crash eodex 477 
Modules EXTM 


An interruptable instruction was executed.and interrupted within 
the system code. This condition is detected when a task is being 
dispatched into system state by TMRD.SYS. Register R9 contains | 
the addtess of the current TCB. Registers RE and RF contain the 
dispatch PSW.. Ss -_ 


Crash code: 180* 
Module: EXTI 


The LFC event service routine was dispatched even though no 
outstanding request existed for this routine to be dispatched. 


Crash code: 185* 
Module: EXTI 


TOCHOFF found the head of the DCB timeout chain to be zero. This 
should never happen since the chain uses nonzero address pointers 
or -1 to signify the end of the chain. Or, TOCHOFF found that 
the DCB that it was trying to remove from the DCB timeout chain 
was not.on the chaine Register RD contains the address of the 
DCB that was to be removed from the timeout chain. . 


Crash code: 186* 
Module: EXTI 


The PIC or LFC event service routines found that the head of the 
timer chain that it was servicing was zero. This should not 
occur since the chain uses either a nonzero address pointer or -1 
to signify the end of the chain. 


Crash codes 1FO 
Module: EXIN 


A system queue interrupt occurred, but the interrupt old PSW 
status had the system queue interrupt enable bit turned off. The 
contents of register set 0 at the time the fault was detected are 
Saved at  EREGS. Registers RE and RF contain the interrupt old 
PSW. 
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Crash code: 1F1 ‘ 
Module: EXIN. 


On a machine with two register sets, the user register set was 
not available for exclusive use. This can be caused by having an 
event service routine not return via SQSEXII. The contents of 
register set 0 at the time the fault was detecteil are saved at 
EREGS. Registers RE and RF contain the interrupt old PSW. 


Crash code: 203*. 
Module: EXIO 


COMQ found that the queueing number that was passed to it as a 
parameter was not in the range of 1 to 4 £=Register 8&9 contains 
the queueing parameter that was passed to COM2. This number 
should not be in the range of 1 to 4 Register RB contains the 
leaf that is being.queued to. Register RA contains the [908 that 
is being queued to the leaf. as 


Crash code: 229* 
Module: EXIO 


CETIOB found that no I03s were available when it tried to 


allocate one. This. should never happen because task is placed 
into connection wait until an I9B becomes free when the last IOB 
is allocated. Register R9 contains the address of the currant 


Crash code: 221* 
Module: EXIO 


RELIOB is trying to release an IOB that is not found in the TCB 
TOB list. It could be an IOB from a DCB, or a corrupted IIB. 
Register R9 contains the address of the current TCB. Register RB 
contains the IOB type. The crash occurred because this number 
Was not a 1. Register RA contains the address of th2 IOB that 
was being released. ; 


Crash codes 230 
Module: EXIO 


A leaf that was added to the system queue had the address of its 
event service routine as 9. Register RF contains the address of 
the leaf being processed. Register RD contains the DCS address 
that was obtained from the leaf. 


Crash code: 250 
Module: INTC 
A system sysgened without the SVC intercept feature tried to 


process an SVC interception. R8 contains the address following 
the call to the intercept routine. 
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Crash codes: 300 
Module: EXTM . 


A task event service routine is being dispatched, but. the task 
does not have a TQH. R9 contains the TCB address. 


Crash code: 301 
Module: EXTH - 


An attempt is made to dispatch a task event when there are none 
available for dispatching. R9 contains the [CB address. 


Crash code: 401* 
Module: EXTMH 


The TCB address of the task being rolled in is not at the head of 
the roll queue, or the TCB.STAT field of the task being rolled in 
has a status bit turned on that is not valid when a task is being 
rolled ine Register R9Y contains the address of the current TCB. 


Crash code: 4O02* 
Module: EXTM 


RINQUE is trying to put a task on the rollin queue, but the 
task's TCB address is invalid. Register RY contains the address 
of the current [TCB. 


Crash code: 403* 
Module: EXTM 


RINDQUE is trying to remove a task from the rollin queus, but the 
task‘s TCB address is invalid. Register R9Y contains the address 
of the current TCB. 


Crash code: LOY 
Module: EXTHM 


In a system without roll support, TMCKUTET found a task was being 
dispatched without any memory in its impure segment. Register R9 
contains the address of the current TCB. . Register RD contains 
the flag field TCB.STAT of the current TCB. 


Crash code: 405 
Module: EXTM 


In a system without roll support, TMCKUTET found the rollin 
Pending bit on. Register RY contains the address of the current 
TCB. Register RD contains the flag field TCB.STAT of the current 
TCR. 
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Crash code; 500 
Module: INITMSM 


The operating system was overwritten by a misdirected DHA 
transfer into memory. Register D contains A(DCB), register 0 
contains the last location overwritten, and register 2 contains 
the physical address of SELCH. 


Crash code: 501 
Module: INITSUBS 


An attempt was made to use two level translation, but the second 
level translation table was not specified. Register 4 contains 
A(CCB); register 6 contains the character being translated. 


Crash code: 801 


ITAM buffer management - End Buffer routine finds CCB with zero 
as the current buffer. This is usually due to improper 
management of the CCW buffer select bit in the CCa. | 


Crash code: 8062 


Attempt to form ring in ITAM timer chain. The CCB is already on 


_ the time chain. 


Crash code: 803 


DCB.ITB field is in illogical state. The fieli is being changed 
incorrectly. oe. - 


Crash codes: 804 


Loss of buffer control using queued buffers. Internal queued 
buffer count is greater than zero but no buffers exist. 


Crash codes 805 


ITAM Buffer Management - RAW-After-Write-Next-Buff routine finds 
zero as the current buffer. 


Crash code: 806 


ITAM Buffer Management - Next-Buff routine entered but buffer 
type is neither chained nor queued. ; ; 


D-10 48-030 FOO ROO 


Crash code: 807 


ITAM Buffer Hanagenent ~ Next-Buff routine finds zero as the 
current buffer. 


Crash code: 808 


ITAM Buffer Management - Next-Buff routine finis zers as the 
noncurrent buffer. 


Crash code: FO1 
Module: EXIo 


A leaf being disconnected from the current task is not queued to 


the task TCB. Register R9 contains the address of the current 
TCB. Register RF contains the address of the leaf being 


disconnected. 
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command summary 
creating files on disk 
error conditions 
exiting from files 
filenames 
files 
passing arguments 
program pauses 
Commands, 0S/32 
DISPLAY 
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BUILD 
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SBUILD 
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DISPLAY commands 
DISPLAY ACCCUNTING command 


task accounting information 


taskid 

DISPLAY DEVICES command .. 
device keys 
device physical address 
direct access devices 
error recording 
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